Ծրագրավորողների համար
Zinn Digital®-ը API-հիմնված հարթակ է: Նույն շարժիչի API-ն, որն աշխատացնում է մեր վահանակը, այն է, ինչ դուք ստանում եք՝ տարբերակավորված, բնութագրի վրա հիմնված և 100%-ով փաստաթղթավորված կառուցման պահին՝ գեներացված SDK-ներով, CLI-ով, Terraform մատակարարով, ստորագրված վեբհուկներով և դրանց վրա աշխատող MCP սերվերով: Անկախ նրանից, թե ինչ եք օգտագործում աշխատելու համար՝ տերմինալ, փողրակ (pipeline), վիճակի ֆայլ կթե արհեստական ինտելեկտի գործակալ, հարթակն արձագանքում է դրանց:
Վեբ-հոսթինգների մեծ մասը API է ավելացնում կառավարման վահանակին հետին թվով, և դա ակնհայտ է. վահանակի գործառույթների կեսը երբեք հասանելի չի դառնում: Մենք ստեղծել ենք հակառակ ուղղությամբ: Վահանակը, ադմինիստրատորի վահանակը, CLI-ը, Terraform մատակարարը, MCP սերվերը և ձեր սեփական ինտեգրումները օգտագործում են միևնույն շարժիչի API-ն: Եթե կարող եք դա անել վահանակում, ուրեմն կարող եք անել նաև կոդի միջոցով:
OpenAPI բնութագիրը ճշմարտության միակ աղբյուրն է, և ոչ մի վերջնակետ չի թողարկվում, քանի դեռ այն ներառված չէ բնութագրում։ Հենց այս միակ կանոնն է, որ հանրային API-ն ամբողջությամբ փաստաթղթավորված է դարձնում կառուցման պահին, այլ ոչ թե հետագայում. չկա չփաստաթղթավորված անկյուն, քանի որ չփաստաթղթավորված վերջնակետ պարզապես գոյություն չունի։
Ինտերակտիվ ուղեցույցները, չորս հաճախորդային SDK-ները, CLI-ի մեծ մասը և Terraform-ի մատուցման հիմնասյունը գեներացվում են այդ մեկ բնութագրից: Մեկ աղբյուր, բազմաթիվ արտեֆակտներ, որոնք միշտ համաժամեցված են. դուք երբեք ստիպված չեք լինի փնտրել փաստաթուղթ, որը շեղվել է իրականացումից:
Վերջնակետերը գործում են /v1 հասցեում՝ հրապարակված հնացման քաղաքականությամբ և փոփոխությունների մատյանով: Ուր որ է, ինչ-որ բան փոխվելիս դուք նախօրոք կտեղեկացվեք գրավոր կերպով, այլ ոչ թե դա կբացահայտեք ձախողված հավաքման արդյունքում:
Իրականացման և սպեցիֆիկացիայի համապատասխանության թեստերը, ինչպես նաև OpenAPI-ի լինթինգը գործարկվում են յուրաքանչյուր փոփոխության դեպքում։ Կոդի և պայմանագրի միջև եղած շեղումը ձախողում է հավաքումը (build), ուստի այն սպեցիֆիկացիան, որից դուք գեներացնում եք ձեր հաճախորդը, հենց այն սպեցիֆիկացիան է, որին սերվերն իրականում հետևում է։
Մուտք գործելու երկու եղանակ, մեկ միասնական սկզբունք դրանց հիմքում։ Անկախ նրանից, թե որն եք օգտագործում, գործում են նույն թույլտվությունների ստուգումները և տվյալների բազայի մակարդակի նույն մեկուսացումը:
Բանալիները ունեն zdk_<mode>_<prefix>_<secret> տեսքը։ Գաղտնիքի պահպանվում է միայն SHA-256 հեշը. մենք չենք կարող կրկին ցույց տալ բանալին թողարկումից հետո, և մեր տվյալների բազա մուտք գործող որևէ մեկը նույնպես չի կարող։ Բանալիներն ունեն հասանելիության տիրույթներ (scopes), կարող են չեղարկվել և տրամադրվում են ըստ կազմակերպությունների, այլ ոչ թե ըստ անհատների։
Սandbox բանալիները առանձնացված են production բանալիներից և աշխատում են sandbox ռեժիմում. չկա իրական վճարում, չկա իրական սպասարկում: Ձեր ինտեգրման թեստերը կարող են օգտագործել API-ն՝ առանց գումար ծախսելու կամ սերվերներ ստեղծելու:
Օգտատերերի սեսիաները նույնականացվում են Keycloak-ի թողարկված JWT-ներով, որոնք ստուգվում են realm-ի հանրային բանալու միջոցով և համապատասխանում են API բանալու Principal օբյեկտին: Վերջնակետերը վերահսկվում են հատիկավոր թույլտվության բանալիներով, ինչպիսիք են sites.create-ը կամ apikeys.manage-ը, որոնք ստուգվում են յուրաքանչյուր կազմակերպության համար. մի կազմակերպության թույլտվությունը մուտք չի ապահովում առանձին, անկախ կազմակերպությունում, չնայած այն տարածվում է դրա ներքոներառված կազմակերպությունների վրա:
Վարձակալի յուրաքանչյուր հարցում աշխատում է տրանզակցիայով, որտեղ Postgres org-ի տիրույթը սահմանվում է հիմնական սուբյեկտից, ուստի մեկուսացումն ապահովվում է տվյալների բազայի, այլ ոչ թե ORM ֆիլտրի միջոցով, որը ինչ-որ մեկը կարող է մոռանալ: Queryset-ի ֆիլտրը դեռևս առկա է որպես խորքային պաշտպանություն:
API-ն հեշտ է գեղեցիկ դարձնել README-ում և դժվար՝ իրական տրաֆիկի պայմաններում աշխատեցնել: Սրանք այն մասերն են, որոնց վրա մենք քրտինք ենք թափել, քանի որ հենց դրանք են խզում ինտեգրացիաները առավոտյան ժամը երեքին:
Նշելու արժանի մի մանրամասն էլ կա, քանի որ այն ձևավորում է զանգվածային աշխատանքի վարքագիծը. կրկնօրինակ դոմենի դեպքում 409 պատասխանը ցանկացած վարձակալի համար պատասխանում է «այս հոստնեյմն այստեղ է հոստ արվա՞ծ» հարցին, ինչը հասցեների հավաքագրման օրակուլ է և իրական ապաանոնիմացման վտանգ Footprint-Free-ի նկատմամբ: Կայքի ստեղծման արագության սահմանափակումը (throttling) կլիներ ծույլ լուծում և միանգամից կկոտրեր զանգվածային տրամադրման (bulk-provisioning) արտադրանքը: Փոխարենը բյուջետավորվում են միայն մերժված կրկնօրինակ դոմենի փորձերը՝ ըստ վստահորդի: Հաջողված ստեղծումները երբեք չեն գանձվում դրանից, այնպես որ կարող եք զանգվածային եղանակով տրամադրել ամբողջ օրը, և ստուգումը գրեթե անմիջապես դադարում է:
Նույն տեխնիկական բնութագրով երեք սպառող՝ աշխատանքի երեք տարբեր եղանակների համար։
Ստեղծված է TypeScript-ի, Python-ի, PHP-ի և Go-ի համար. հետևում է սպեցիֆիկացիային, որպեսզի նոր վերջնակետը հասնի ձեր լեզվով՝ առանց ձեռքով գրված վրդովի սպասելու:
Ստեղծեք WordPress կայքի հիմքը, գործարկեք այն տեղական մակարդակում՝ տեղադրելով միայն Node, և տեղակայեք այն: Zinnector®-ը նախնական ստուգում է անցկացնում ձեր նախագծի համար այն սլոթի նկատմամբ, որին պատրաստվում եք տեղակայել (PHP տարբերակ, սկավառակ, ֆայլերի քանակ), և նախազգուշացնում է մինչև տեղադրելը, այլ ոչ թե հետո: Այն նաև մուտք է գործում, թվարկում կայքերը, տեղակայում, կառավարում դոմեյններն ու DNS-ը, կարդում փոստային ծառայությունները, կատարում պահուստային պատճեններ, գործարկում թույլատրված ցանկում գտնվող WP-CLI-ն, հետևում լոգերին և կատարում զանգվածային գործողություններ: Անվճար է, ունի MIT արտոնագիր և կառուցված է այս նույն հանրային API-ի վրա:
Կառավարեք կայքերը, դոմենները, DNS գրառումները, փոստարկղերը և պլանները որպես ենթակառուցվածք՝ որպես կոդ։ terraform apply-ն տրամադրում է հոսթինգ, և ձեր միջավայրերը դառնում են վերարտադրվող և ստուգվող՝ ոչ թե սեղմումների հաջորդականություն, որը ոչ ոք չի գրել:
Ստեղծված փաստաթղթեր, որոնք կարող եք կարդալ և կանչել բրաուզերից՝ նկարագրելով հենց այն վերջնակետերը, որոնք սերվերն իրականացնում է, քանի որ երկուսն էլ բխում են նույն բնութագրից:
Պլատֆորմի հիմքում ընկած է հուսալի իրադարձությունների հիմնասյուն. ցանկացած վիճակի փոփոխություն գրում է իրադարձություն Postgres-ի տրանսակցիոն outbox-ում՝ տվյալների բազայի փոփոխության հետ ատոմար կերպով, և փոխանցման մեխանիզմն (relay) այն հրապարակում է NATS JetStream-ում: Իրադարձություններն ունեն տիպեր և տարբերակներ՝ site.deployed, order.paid, invoice.overdue, backup.completed, abuse.flagged, trial.ending և մնացածը:
Գրանցեք վերջնակետը որպես WebhookSubscription և ընտրեք իր ստացած իրադարձությունների տեսակները: Մեկ հոսքը սնուցում է ծանուցումները, վերլուծությունները, ավտոմատացումները և ձեր ինտեգրումը միասին. դուք օգտագործում եք նույն իրադարձությունները, ինչ մենք:
Յուրաքանչյուր առաքում ստորագրված է HMAC-ով, որպեսզի կարողանաք հաստատել դրա իսկությունը և համոզվել, որ այն ուղարկվել է մեզնից, նախքան որևէ գործողություն ձեռնարկելը:
Անհաջող առաքումները կրկնվում են հապաղումով (backoff), և յուրաքանչյուր փորձ գրանցվում է որպես WebhookDelivery: Դուք կարող եք ստուգել և վերարտադրել առաքումները ղեկավարման վահանակից՝ աջակցման ծառայությանը էլեկտրոնային նամակ գրելու և մեր ուղարկածի մասին հարցնելու փոխարեն:
Խողովակաշարը միտումնավոր առնվազն-մեկ-անգամ (at-least-once) է, այլ ոչ թե ձեվանում է, թե ճիշտ-մեկ-անգամ (exactly-once) է։ Հրատարակման ընթացքում խափանված փոխանցիչն ունի իր պահանջի վարձակալության ժամկետի ավարտ և նրա իրադարձությունները նորից են հրատարակվում։ Նույնականացումը (Dedupe) կատարեք ծրարի նույնականացուցչով (envelope id), և ձեր սպառողը ճիշտ կլինի ըստ կառուցվածքի:
API-ն ծրագրավորողի պատմության միայն կեսն է: Մյուս կեսը թողարկումն է:
API-ն մեկ դուռ է: Սրանք մյուս չորսն են, և դրանցից յուրաքանչյուրը ներառված է պլանի մեջ, այլ ոչ թե վաճառվում է որպես մշակողի մակարդակ:
VS Code-ը բրաուզերում, որը բացվում է կայքի էջից կառավարման վահանակում, խմբագրում է այդ կայքի իրական ֆայլերը ներկառուցված git-ով և ամբողջ խմբագրիչով ձեր SFTP հասանելիության հետ նույն CageFS բանտում (jail): Այն խմբագրում է ԿԱՅՔԻ ՈՒՂԻՂ (LIVE) տարբերակը. միջանկյալ փորձնական (staging) պատճեն չկա, ուստի ձեր պահպանած ֆայլը հանրային է դառնում գրվելու պահին:
Անվճար, MIT լիցենզիայով և կառուցված այս նույն հանրային API-ի վրա: Ստեղծեք WordPress կայք, գործարկեք այն ձեր սեփական մեքենայի վրա, նախնական ստուգման ենթարկեք այն տեղադրման ենթակա տարածքի նկատմամբ (PHP տարբերակ, սկավառակ, ֆայլերի քանակ) և տեղադրեք: Անհրաժեշտ է Node 24 կամ ավելի նոր տարբերակ:
Գործիքների մեկ կատալոգ, որպեսզի ձեր արդեն իսկ օգտագործվող արհեստական բանականության հաճախորդը կարողանա աշխատել ձեր կայքերի վրա նույն API-ի և նույն թույլտվությունների միջոցով, որոնք օգտագործում է կառավարման վահանակը: Այն նույն սերվերը, որին միանում է ձեր սեփական հաճախորդը, միացված է վեբ խմբագրիչին: Միայն կարդալու համար նախատեսված ռեժիմում, քանի դեռ այլ բան չեք նշել:
Հաճախորդի հետ աշխատելու համար ձեր գաղտնաբառը պետք չէ: Հրավիրեք որևէ մեկին էլ. փոստի հասցեով, և նրանք ստանում են հենց մեկ կայք. նրանք մուտք են գործում որպես իրենք՝ դիտողի, խմբագրի կամ կառավարչի դերով, և ցանկացmış այլ կայք վերադարձնում է 404 սխալ՝ նախքան որևէ մշակչի աշխատելը. Postgres-ի տողերի մակարդակի անվտանգության քաղաքականություն և հարցման մակարդակի արգելք, այլ ոչ թե մի պարզ ստուգում: Հաշվի սեփականատերը տրամադրում և չեղարկում է այն մեկ սեղմումով, որն ուժի մեջ է մտնում նրանց հաջորդ հարցման ժամանակ:
Մենք հարթակը տրամադրում ենք որպես հոսթինգում աշխատող MCP սերվեր՝ շարժիչի API-ի վրա աշխատող բարակ արձանագրության ադապտեր, որն օգտագործում է նույնական գործողությունների կատալոգը, RBAC-ը և աուդիտի մատյանը: Միացրեք Claude Code-ը, Cursor-ը, ChatGPT-ն, Claude Desktop-ը կամ MCP-ին աջակցող ցանկացած հաճախորդ մեկ անգամ, և API-ին մեր ավելացրած յուրաքանչյուր հնարավորություն ավտոմատ կերպով հասանելի կդառնա դրան:
Գործակալն ստանում է երեք բան. Գործիքներ (նույն API վերջնակետերը, առանց զուգահեռ տրամաբանության, որը կարող է շեղվել), Ռեսուրսներ (կայքի առողջության միայն կարդալու համար նախատեսված վիճակ, կարգավորումներ, վերջին մատյաններ, չափումներ, աշխատունակության ժամանակ և KB հոդվածներ, որպեսզի այն գործելուց առաջ ախտորոշի իրական տվյալներով) և Հուշումներ (հրապարակված աշխատանքային հոսքի ձևանմուշներ, ինչպիսիք են՝ «ախտորոշել այս կայքը» կամ «նախապատրաստել միգրացիա»):
Անվտանգությունը նույնն է, ինչ նույնականացումը՝ OAuth 2.1, ձեր կազմակերպությանը կապված թոքեններ և RBAC թույլտվություններ՝ տողային մակարդակի անվտանգությամբ, յուրաքանչյուր գործիքի համար սահմանափակված և հետկանչելի, պրոդակշնից առանձնացված սանդբոքս: Destructive actions — delete, suspend, billing, large spend — պահանջում են հստակ հաստատում կամ մարդու կողմից հաստատման քաղաքականություն: Արագության սահմանափակումները և ծախսերի շեմերը սահմանափակում են վճարովի AI գործողությունները, և MCP-ի յուրաքանչյուր կանչ գրանցվում է աուդիտի մատյանում՝ ինքնության, գործիքի, արգումենտների և արդյունքի հետ միասին:
Մենք աջակցում ենք արձանագրությանը, այլ ոչ թե ինտեգրում յուրաքանչյուր հավելված առանձին-առանձին, ինչը նշանակում է, որ ձեր ընտրած արհեստական բանականության գործիքակազմը կարող է փոխվել՝ առանց ձեր հոսթինգային ինտեգրման փոփոխության:
Այո՛, սա նույն շարժիչի API-ն է՝ հրապարակված և ամրապնդված: Վահանակը, ադմինիստրատորի կառավարման վահանակը, CLI-ն, Terraform մատակարարը, MCP սերվերը և վեբհուքերը բոլորն էլ մեկ մակերևույթի սպառողներ են, ինչի պատճառով էլ API-ն չի հետ մնում պանելից:
Այո։ Սանդբոքսի բանալիները տրամադրվում են արտադրական բանալիներից առանձին և աշխատում են թեստային ռեժիմով. չկա իրական վճարում և իրական տրամադրում։ Ուղղեք ձեր CI-ն դեպի սանդբոքսի հավատարմագրերը և անվտանգ փորձարկեք հարցումների ու պատասխանների ամբողջական ցիկլը։
Ուղարկեք Idempotency-Key ձեր POST հարցման հետ։ Կրկնվող հարցման գրառումը կատարվում է հաստատման (commit), այլ ոչ թե անմիջապես պահին, հետևաբար կրկնակի փորձը երբեք չի կարող վերարտադրել կեշավորված հաջողությունը այն տողի համար, որն իրականում չի հաստատվել, և ձախողված հարցումն անմիջապես ազատում է իր արգելափակումը, որպեսզի ձեր ուղղված կրկնակի փորձը չարգելափակվի։ Վեբհուկների առաքումն ըստ նախագծի առնվազն մեկ անգամ է. կատարեք կրկնօրինակների հեռացում (dedupe) envelope id-ի միջոցով ձեր կողմում:
Այսօր ոչ։ API բանալիները տրամադրվում են ըստ կազմակերպությունների, ուստի մի քանի հաճախորդային կազմակերպություններ ընդգրկող ինտեգրացիան ունի առանձին բանալի յուրաքանչյուրի համար։ Թույլտվությունները նույնպես ստուգվում են ըստ կազմակերպությունների՝ օգտատերերի մուտքային տվյալների համար. sites.create-ի առկայությունը մեկ կազմակերպությունում որևէ հասանելիություն չի տալիս մեկ այլ, անկախ կազմակերպությունում, թեև այն տարածվում է դրանում ներառված ենթակազմակերպությունների վրա։ Սա միտումնավոր է արված՝ վտանգված բանալին սահմանափակելով միայն տվյալ կազմակերպությամբ և դրա տակ գտնվող ենթակազմակերպություններով, այլ ոչ թե ամբողջ հարթակով։
Ծրագրավորողի դերը ներառում է կազմակերպության կարդալու հասանելիությունը, API բանալիների կառավարումը, կայքերի դիտումն ու ստեղծումը, դրանց վերագործարկումը, քեշի մաքրումը, ինչպես նաև տոմսերի դիտումն ու դրանց պատասխանելը։ Այն միտումնավորաբար բացառում է վճարումների վերահսկումը։ Նկատի ունեցեք, որ տեղակայման (deploy) և «ուղիղ եթեր» մղելու (push-to-live) թույլտվությունները ներառված չեն դրանում. եթե թիմի անդամին դրանք անհրաժեշտ են, նշանակեք համապատասխան դեր, այլ ոչ թե ենթադրեք, թե Ծրագրավորողն ամենալայն տեխնիկական դերն է։
Առաքումները կրկնվում են աստիճանաբար աճող ընդմիջումներով, և յուրաքանչյուր փորձ գրանցվում է որպես WebhookDelivery, որը կարող եք ստուգել։ Վերին հոսքում իրադարձությունները գրվում են տրանզակցիոն արկղի (outbox) մեջ՝ փոփոխության հետ նույն տվյալների բազայի տրանզակցիայում, այնպես որ ոչինչ չի կորչում, մինչ սպառողը անհասանելի է. անջատված սպառողը պարզապես հետ է մնում, այն երբեք չի կոտրում արտադրողին, և դուք կարող եք կրկնարկել առաքումները վահանակից, երբ այն նորից հասանելի դառնա:
Սկսեք Footprint-Free Hosting-ի առանց քարտի պահանջի 14-օրյա փորձաշրջանից. վճարային տվյալներ չեն պահանջվում, մինչև 5 կայք: Վճարովի Footprint-Free սակագնային պլանները սկսվում են ամսական $6-ից PBN 5-ի համար: Յուրաքանչյուր պլան ներառում է 30-օրյա գումարի վերադարձի երաշխիք, անվճար միգրացիա և մատակարարին կապվածության բացակայություն:
«Spec-first» API, գեներացված SDK-ներ, CLI, Terraform provid-եր, ստորագրված վեբհուկներ (webhooks) և MCP սերվեր՝ այն հոսթինգում, որը մենք ստեղծել ենք ողջ աշխարհում 650,000+ կայքերի համար: Սկսեք 14-օրյա փորձաշրջանը առանց բանկային քարտի և վճարային տվյալների:
Սկսեք անվճար