Ծրագրավորողների համար
Zinn Digital®-ը API-ի առաջնահերթությամբ հարթակ է։ Շարժիչի նույն API-ն, որն աշխատեցնում է մեր կառավարման վահանակը, հենց այն է, ինչ դուք եք ստանում՝ տարբերակավորված, սպեցիֆիկացիային նախապատվություն տվող և կառուցման պահին 100%-ով փաստաթղթավորված, որին գումարվում են գեներացված SDK-ները, CLI-ն, Terraform պրովայդերը, ստորագրված վեբհուքերը և MCP սերվերը։ Անկախ նրանից, թե ինչ եք օգտագործում աշխատանքի համար՝ տերմինալ, փայփլայն, վիճակի ֆայլ, թե AI գործակալ, հարթակն արձագանքում է դրան։
Հոսթինգ մատակարարների մեծ մասը API-ն ավելացնում է կառավարման վահանակին հետին թվով, և դա ակնհայտ է դառնում. վահանակի հնարավորությունների կեսը երբեք չի հասնում այնտեղ: Մենք կառուցել ենք ճիշտ հակառակ սկզբունքով: Կառավարման վահանակը, ադմինիստրատորի վահանակը, CLI-ն, Terraform-ի մատակարարը, MCP սերվերը և ձեր սեփական ինտեգրումները օգտագործում են միևնույն շարժիչի API-ն: Եթե դուք կարող եք դա անել վահանակում, կարող եք դա անել նաև կոդով:
OpenAPI-ի հստակեցումը ճշմարտության միակ աղբյուրն է, և ոչ մի վերջնակետ չի թողարկվում, եթե այն ներառված չէ հստակեցման մեջ: Հենց այս մեկ կանոնն է ապահովում, որ հանրային API-ն ամբողջությամբ փաստաթղթավորվի կառուցման պահին, այլ ոչ թե հետագայում — չկա որևէ չփաստաթղթավորված անկյուն, քանի որ չփաստաթղթավորված վերջնակետ պարզապես չի կարող գոյություն ունենալ:
Ինտերակտիվ տեղեկատու փաստաթղթերը, չորս հաճախորդային SDK-ները, CLI-ի մեծ մասը և Terraform մատակարարի կառուցվածքը բոլորը գեներացվում են այդ մեկ բնութագրից: Մեկ աղբյուր, բազմաթիվ արտեֆակտներ, միշտ համաժամեցված — դուք երբեք ստիպված չեք լինի փնտրել իրականացումից շեղված փաստաթուղթը:
Վերջնակետերը գտնվում են /v1-ի տակ՝ հրապարակված հնացման քաղաքականությամբ և փոփոխությունների մատյանով: Փոփոխություններից առաջ դուք տեղեկացվում եք գրավոր կերպով, ոչ թե դրա մասին իմանում եք ձախողված կառուցումից:
Իրականացման և տեխնիկական բնութագրի պայմանագրային թեստերը, ինչպես նաև OpenAPI-ի ստուգումը գործարկվում են յուրաքանչյուր փոփոխության դեպքում: Կոդի և պայմանագրի միջև անհամապատասխանությունը հանգեցնում է կառուցման ձախողմանը, այնպես որ այն տեխնիկական բնութագիրը, որից գեներացնում եք Ձեր հաճախորդային ծրագիրը, հանդիսանում է հենց այն բնութագիրը, որը սերվերը փաստացի պահպանում է:
Մուտքի երկու եղանակ, դրանց հետևում՝ մեկ միասնական սկզբունք: Որն էլ որ օգտագործեք, կիրառվում են թույլտվությունների նույն ստուգումները և տվյալների բազայի մակարդակով նույն մեկուսացումը:
Բանալիներն ունեն հետևյալ տեսքը՝ zdk_<mode>_<prefix>_<secret>: Պահպանվում է գաղտնիքի միայն SHA-256 հեշը. մենք չենք կարող թողարկումից հետո կրկին ցույց տալ ձեզ բանալին, ինչպես նաև դա չի կարող անել որևէ մեկը, ով մուտք կունենա մեր տվյալների բազա: Բանալիներն ունեն շրջանակներ, կարող են չեղարկվել և տրամադրվում են ըստ կազմակերպության, այլ ոչ թե ըստ անձի:
Sandbox-ի բանալիները տարանջատված են արտադրական (production) բանալիներից և գործում են sandbox ռեժիմում. չկա իրական հաշվարկ, չկա ռեսուրսների իրական տրամադրում: Ձեր ինտեգրացիոն թեստերը կարող են ծանրաբեռնել API-ն՝ առանց գումար ծախսելու կամ սերվերներ ստեղծելու:
Օգտատիրոջ սեսիաները վավերացվում են Keycloak-ի կողմից տրամադրված JWT-ներով, ստուգվում են տիրույթի (realm) հանրային բանալիով և վերածվում են նույն Principal օբյեկտին, ինչ API բանալին: Վերջնակետերը սահմանափակվում են մանրամասն թույլտվության բանալիներով, ինչպիսիք են sites.create կամ apikeys.manage, որոնք ստուգվում են ըստ կազմակերպության — մեկ կազմակերպությունում առկա թույլտվությունը մուտքի իրավունք չի տալիս առանձին, չկապակցված կազմակերպությունում, թեև այն կիրառվում է դրա տակ ներդրված կազմակերպությունների համար:
Յուրաքանչյուր վարձակալի հարցում կատարվում է գործարքի շրջանակում, որտեղ Postgres կազմակերպության շրջանակը սահմանվում է հիմնական սուբյեկտից, ուստի մեկուսացումն ապահովվում է տվյալների բազայի կողմից, ոչ թե ORM զտիչի միջոցով, որը որևէ մեկը կարող է մոռանալ: Queryset զտիչը դեռևս պահպանվում է որպես խորքային պաշտպանություն:
Հեշտ է API-ն գեղեցիկ ներկայացնել README-ում, բայց դժվար է ապահովել դրա պատշաճ աշխատանքը իրական տրաֆիկի պայմաններում: Սրանք այն մասերն են, որոնց վրա մենք քրտնաջան աշխատել ենք, քանի որ հենց դրանք են գիշերվա ժամը երեքին խափանում ինտեգրումները:
Մի մանրամասն, որն արժե առանձնացնել, քանի որ այն ձևավորում է մեծաքանակ աշխատանքի ընթացքը. կրկնվող տիրույթի (domain) դեպքում 409 սխալը ցանկացած վարձակալի համար պատասխանում է «արդյո՞ք այս host-ի անունը հոսթինգ է ստանում այստեղ» հարցին, ինչը հանդիսանում է enumeration oracle և Footprint-Free-ի դեմ ապաանանունացման իրական ռիսկ: Կայքերի ստեղծման արագության սահմանափակումը (throttling) կլիներ հեշտագույն լուծումը և ամբողջությամբ կխաթարեր մեծաքանակ տրամադրման (bulk-provisioning) պրոդուկտի աշխատանքը: Փոխարենը, մեկ principal-ի հաշվով սահմանաչափում հաշվի են առնվում միայն կրկնվող տիրույթի մերժված փորձերը: Հաջողված ստեղծումները երբեք չեն հաշվարկվում դրա դեմ, հետևաբար դուք կարող եք մեծ ծավալներով գործարկումներ կատարել ողջ օրը, իսկ տվյալների որոնման փորձերը կասեցվում են գրեթե անմիջապես:
Միևնույն բնութագրի երեք սպառող՝ աշխատանքի երեք տարբեր եղանակների համար:
Ստեղծված է TypeScript-ի, Python-ի, PHP-ի և Go-ի համար՝ հետևելով սպեցիֆիկացիային, որպեսզի նոր վերջնակետը հասանելի լինի ձեր լեզվով՝ առանց ձեռքով գրված փաթեթավորիչին սպասելու։
Ստեղծեք WordPress կայքի կմախքը, գործարկեք այն տեղայնորեն՝ առանց որևէ այլ բան տեղադրելու, բացի Node-ից, և տեղակայեք այն։ Zinnector®-ը նախապես ստուգում է Ձեր նախագիծը այն սլոթի նկատմամբ, որտեղ պատրաստվում եք տեղակայել՝ PHP տարբերակ, սկավառակ, ֆայլերի քանակ, և նախազգուշացնում է նախքան ուղարկելը, այլ ոչ թե հետո։ Այն նաև մուտք է գործում համակարգ, թվարկում է կայքերը, տեղակայում է, կառավարում է դոմեյններն ու DNS-ը, կարդում է փոստային ծառայությունները, ստեղծում է պահուստային պատճեններ, գործարկում է սպիտակ ցուցակում ներառված WP-CLI, հետևում է մատյաններին և իրականացնում է զանգվածային գործողություններ։ Անվճար է, ունի MIT արտոնագիր և կառուցված է հենց այս հանրային API-ի հիման վրա։
Կառավարեք կայքերը, դոմեյնները, DNS գրառումները, էլփոստի արկղերը և պլանները որպես ենթակառուցվածք՝ որպես կոդ: terraform apply-ը տրամադրում է հոսթինգ, և ձեր միջավայրերը դառնում են վերարտադրելի ու վերանայելի՝ այն սեղմումների հաջորդականության փոխարեն, որոնք ոչ ոք չի գրանցել:
Գեներացված փաստաթղթեր, որոնք կարող եք կարդալ և կանչել բրաուզերից՝ ճշգրիտ նկարագրելով սերվերի կողմից իրականացվող վերջնակետերը, քանի որ երկուսն էլ բխում են նույն տեխնիկական բնութագրից:
Հարթակի հիմքում ընկած է իրադարձությունների կայուն առանցք. վիճակի յուրաքանչյուր փոփոխություն տվյալների բազայի փոփոխության հետ ատոմար կերպով իրադարձություն է գրանցում Postgres-ի տրանզակցիոն ելքային արկղում, իսկ ռելեն այն հրապարակում է NATS JetStream-ում: Իրադարձություններն ունեն տիպեր և տարբերակներ՝ site.deployed, order.paid, invoice.overdue, backup.completed, abuse.flagged, trial.ending և մնացածը:
Գրանցեք վերջնակետը որպես WebhookSubscription և ընտրեք այն իրադարձությունների տեսակները, որոնք այն ստանում է: Մեկ հոսքը հավասարապես սնուցում է ծանուցումները, վերլուծությունները, ավտոմատացումները և ձեր ինտեգրումը — դուք օգտագործում եք նույն իրադարձությունները, ինչ մենք:
Յուրաքանչյուր առաքում ունի HMAC ստորագրություն, որպեսզի գործողություն ձեռնարկելուց առաջ կարողանաք ստուգել, որ այն ստացվել է մեզանից:
Չհաջողված առաքումները կրկին փորձարկվում են հետաձգմամբ, և յուրաքանչյուր փորձ գրանցվում է որպես WebhookDelivery: Դուք կարող եք ստուգել և վերագործարկել առաքումները կառավարման վահանակից՝ աջակցման թիմին նամակ գրելու և մեր ուղարկածի մասին հարցնելու փոխարեն:
Խողովակաշարը միտումնավոր աշխատում է «առնվազն մեկ անգամ» սկզբունքով՝ «ճիշտ մեկ անգամ» ձևանալու փոխարեն: Հրապարակման ընթացքում ընդհատված ռելեի պահանջի վարձակալության ժամկետը լրանում է, և դրա իրադարձությունները վերահրապարակվում են: Կատարեք կրկնօրինակների հեռացում ծրարի նույնացուցիչով, և ձեր սպառողը կառուցվածքով կլինի ճիշտ:
API-ն ծրագրավորողի պատմության միայն կեսն է: Մյուս կեսը թողարկումն է:
API-ը մեկ դուռ է: Սրանք մյուս չորսն են, և դրանցից յուրաքանչյուրը ներառված է սակագնային պլանում, այլ ոչ թե վաճառվում է որպես ծրագրավորողների մակարդակ:
VS Code բրաուզերում, բացված կառավարման վահանակի կայքի էջից, որը խմբագրում է տվյալ կայքի իրական ֆայլերը ներկառուցված git-ով և ամբողջ խմբագրիչով նույն CageFS jail-ի ներսում, ինչ Ձեր SFTP մուտքը: Այն խմբագրում է ԻՐԱԿԱՆ (LIVE) կայքը — միջանկյալ ստուգիչ (staging) պատճեն չկա, ուստի Ձեր պահպանած ֆայլը դառնում է հրապարակային հենց գրվելու պահին, թեև ստատիկ ֆայլը կարող է շարունակել մատուցվել CDN քեշից մինչև չորս ժամ:
Անվճար, MIT լիցենզիայով և կառուցված այս նույն հանրային API-ի հիման վրա։ Ստեղծեք WordPress կայքի կմախքը, գործարկեք այն ձեր սեփական մեքենայում, նախնական ստուգում անցկացրեք այն սլոթի հետ, որտեղ պատրաստվում եք տեղակայել — PHP տարբերակ, սկավառակ, ֆայլերի քանակ — և տեղակայեք։ Պահանջվում է Node 24 կամ ավելի նոր տարբերակ։
Գործիքների մեկ կատալոգ, որպեսզի ձեր կողմից արդեն օգտագործվող AI հաճախորդը կարողանա աշխատել ձեր կայքերում նույն API-ի և նույն թույլտվությունների միջոցով, որոնք օգտագործում է կառավարման վահանակը: Նույն սերվերը, որին միանում է ձեր սեփական հաճախորդը, միացված է վեբ խմբագրիչին: Միայն կարդալու համար, քանի դեռ այլ բան չեք նշել:
Հաճախորդների հետ աշխատանքի համար Ձեր գաղտնաբառը պետք չէ։ Հրավիրեք որևէ մեկին էլփոստի հասցեով, և նա կստանա հստակ մեկ կայք. նրանք մուտք են գործում իրենց անունով՝ դիտողի, խմբագրի կամ կառավարչի դերով, իսկ ցանկացած այլ կայք պատասխանում է 404 սխալով, նախքան որևէ մշակիչի գործարկվելը — Postgres-ի տողի մակարդակի անվտանգության քաղաքականություն և հարցման մակարդակի պատնեշ, ոչ թե մեկ ստուգում։ Հաշվի սեփականատերը տրամադրում և չեղարկում է այն մեկ սեղմումով, որն ուժի մեջ է մտնում նրանց հաջորդ հարցումից:
Մենք հարթակը տրամադրում ենք որպես հոսթինգ ապահովող MCP սերվեր՝ շարժիչի API-ի վրա գտնվող բարակ արձանագրության ադապտեր, որը վերաօգտագործում է նույն գործողությունների կատալոգը, RBAC-ը և աուդիտի հետքը: Մեկ անգամ միացրեք Claude Code-ը, Cursor-ը, ChatGPT-ն, Claude Desktop-ը կամ MCP-ի հնարավորություն ունեցող ցանկացած հաճախորդ, և API-ում մեր ավելացրած յուրաքանչյուր հնարավորություն ավտոմատ կերպով հասանելի կդառնա դրա համար:
Գործակալը ստանում է երեք բան. Գործիքներ (նույն API վերջնակետերը, առանց զուգահեռ տրամաբանության, որը կարող է շեղվել), Ռեսուրսներ (միայն կարդալու համար կայքի վիճակ, կազմաձևում, վերջին գրանցամատյաններ, չափումներ, անխափան աշխատանքի ժամանակ և գիտելիքների բազայի հոդվածներ, որպեսզի այն գործելուց առաջ ախտորոշի իրական տվյալներով) և Հուշումներ (հրապարակված աշխատանքային հոսքի կաղապարներ, ինչպիսիք են՝ «ախտորոշել այս կայքը» կամ «նախապատրաստել տեղափոխումը»):
Անվտանգությունը նույն սկզբունքին է հետևում, ինչ նույնականացումը՝ OAuth 2.1, Ձեր կազմակերպությանը կապված թոքեններ և տողերի մակարդակի անվտանգությամբ ապահովված RBAC թույլտվություններ, որոնք ունեն հստակ շրջանակ և հետկանչելի են յուրաքանչյուր գործիքի համար, իսկ ավազարկղը (sandbox) առանձնացված է արտադրական միջավայրից: Կործանարար գործողությունները՝ ջնջում, կասեցում, հաշվարկներ, խոշոր ծախսեր, պահանջում են հստակ հաստատում կամ մարդու կողմից հաստատման քաղաքականություն: Հարցումների հաճախականության սահմանափակումները և ծախսերի շեմերը սահմանափակում են AI-ի կողմից նախաձեռնվող վճարովի գործողությունները, իսկ յուրաքանչյուր MCP կանչ գրանցվում է աուդիտի մատյանում՝ ինքնության, գործիքի, արգումենտների և արդյունքի մանրամասներով:
Մենք աջակցում ենք արձանագրությանը, այլ ոչ թե յուրաքանչյուր հավելվածի առանձին ինտեգրմանը, ինչը նշանակում է, որ AI գործիքների Ձեր ընտրությունը կարող է փոխվել առանց հոսթինգի ինտեգրման փոփոխության:
Այո — դա նույն շարժիչի API-ն է՝ հրապարակված և ամրապնդված: Կառավարման վահանակը, ադմինիստրատորի վահանակը, CLI-ն, Terraform պրովայդերը, MCP սերվերը և webhook-ները բոլորը մեկ մակերեսի սպառողներ են, ինչի պատճառով էլ API-ն հետ չի մնում վահանակից:
Այո։ Sandbox բանալիները տրամադրվում են արտադրական բանալիներից առանձին և աշխատում են փորձարկման ռեժիմով՝ առանց իրական գանձումների և առանց իրական ապահովման։ Ուղղեք ձեր CI-ը դեպի sandbox-ի նույնականացման տվյալները և ապահով կերպով փորձարկեք հարցման և պատասխանի ողջ ցիկլը։
Ուղարկեք Idempotency-Key ձեր POST հարցման մեջ: Կրկնության գրառումը գրվում է commit-ի ժամանակ, այլ ոչ թե inline, ուստի կրկնակի փորձը երբեք չի կարող վերարտադրել քեշավորված հաջողությունը այն տողի համար, որն իրականում չի կատարվել (commit), իսկ ձախողված հարցումն անմիջապես ազատում է իր կողպումը, որպեսզի ձեր ուղղված կրկնակի փորձը չհետաձգվի: Webhook-ի առաքումը ըստ նախագծման առնվազն մեկ անգամ է (at-least-once) — հեռացրեք կրկնօրինակները ձեր կողմից ըստ envelope id-ի:
Ոչ այսօր։ API բանալիները տրամադրվում են ըստ կազմակերպության, ուստի մի քանի հաճախորդ կազմակերպություններ ընդգրկող ինտեգրումը յուրաքանչյուրի համար բանալի ունի։ Թույլտվությունները նույնպես ստուգվում են ըստ կազմակերպության՝ օգտատերերի սուբյեկտների համար․ մեկ կազմակերպությունում sites.create ունենալը մուտքի իրավունք չի տալիս առանձին, չկապակցված կազմակերպությունում, թեև այն կիրառվում է դրա տակ գտնվող կազմակերպությունների նկատմամբ։ Դա միտումնավոր է արված. այն սահմանափակում է վտանգված բանալին իր սեփական կազմակերպությամբ և դրա տակ գտնվող ենթակազմակերպություններով, ոչ թե ամբողջ հարթակով։
dev դերը ներառում է կազմակերպության տվյալների ընթերցումը, API բանալիների կառավարումը, կայքերի դիտումն ու ստեղծումը, դրանց վերագործարկումը, դրանց քեշի մաքրումը, ինչպես նաև հարցումների (tickets) դիտումն ու դրանց պատասխանելը: Այն միտումնավոր բացառում է վճարումների կառավարումը: Նկատի ունեցեք, որ տեղակայման (deploy) և push-to-live թույլտվությունները դրա մաս չեն կազմում. եթե թիմի անդամին անհրաժեշտ են դրանք, նշանակեք այնպիսի դեր, որը ներառում է դրանք, այլ ոչ թե ենթադրեք, որ Developer-ը ամենալայն տեխնիկական դերն է:
Առաքումները կրկին փորձարկվում են հետաձգմամբ (backoff), և յուրաքանչյուր փորձ գրանցվում է որպես WebhookDelivery, որը դուք կարող եք ստուգել: Վերին մակարդակում իրադարձությունները գրանցվում են գործարքային ելքային արկղում (transactional outbox) տվյալների բազայի նույն գործարքի շրջանակում, ինչ հենց փոփոխությունը, հետևաբար ոչինչ չի կորչում, քանի դեռ սպառողն անհասանելի է — անջատված սպառողը հետ է մնում, սակայն երբեք չի խափանում արտադրողի աշխատանքը, և վերադառնալուց հետո դուք կարող եք վերագործարկել առաքումները կառավարման վահանակից:
Սկսեք Footprint-Free հոսթինգի 14-օրյա փորձաշրջանը առանց բանկային քարտի՝ առանց վճարային տվյալների, մինչև 5 կայքի համար: Footprint-Free-ի վճարովի սակագները սկսվում են ամսական $6-ից՝ PBN 5-ի համար: Յուրաքանչյուր պլան ներառում է գումարի վերադարձի 30-օրյա երաշխիք, անվճար տեղափոխումներ և կախվածության բացակայություն որևէ մատակարարից:
Սպեցիֆիկացիայի վրա հիմնված API, գեներացված SDK-ներ, CLI, Terraform մատակարար, ստորագրված վեբհուկներ և MCP սերվեր — ամբողջ աշխարհում 700,000+ կայքերի համար մեր ստեղծած հոսթինգում։ Սկսեք 14-օրյա փորձաշրջանով՝ առանց քարտի և առանց վճարային տվյալների։
Սկսեք անվճարԱյս պլագիններից յուրաքանչյուրը ձեր WordPress կայքը դարձնում է MCP սերվեր, որպեսզի Claude, Cursor, VS Code և այլ արհեստական բանականության օգնականներ կարողանան իրական աշխատանք կատարել դրա վրա՝ մուտք գործելով որպես դուք և սահմանափակվելով միայն այն ամենով, ինչ ձեզ թույլատրված է անել: