Барои таҳиягарон
Zinn Digital® як платформаи API-first аст. API-и ҳамон муҳаррике, ки панели идоракунии моро таъмин мекунад, ҳамон чизест, ки шумо мегиред — версиябандишуда, бо мушаххасоти пешакӣ ва 100% ҳуҷҷатгузоришуда дар вақти сохтмон, бо SDK-ҳои тавлидшуда, CLI, провайдери Terraform, вебҳукҳои имзошуда ва сервери MCP дар болои он. Ҳар чизе ки шумо барои кор истифода мебаред — терминал, пайванд (pipeline), файли ҳолат ё агенти AI — платформа ба он ҷавоб медиҳад.
Аksari miyandorho API-ro пас аз анҷом ба панели идоракунӣ васл мекунанд ва ин намоён аст — нисфи хусусиятҳои панел ҳеҷ гоҳ дастнорас нестанд. Мо бо тартиби баръакс сохтем. Панели идоракунӣ, консоли маъмурӣ, CLI, провайдери Terraform, сервери MCP ва интегратсияҳои худсохтаи шумо ҳама аз як API-и муҳаррик истифода мебаранд. Агар шумо онро дар панел иҷро карда тавонед, پس онро дар код низ иҷро карда метавонед.
Мушаххасоти OpenAPI манбаи ягонаи ҳақиқат аст ва ҳеҷ гуна нуқтаи ниҳоӣ (endpoint) бидуни мавҷуд будан дар мушаххасот бароварда намешавад. Ҳамон як қоидаи ягона аст, ки API-и оммавиро на дертар, балки ҳангоми сохтмон пурра ҳуҷҷатгузорӣ мекунад — ягон кунҷи беҳуҷҷат вуҷуд надорад, зеро нуқтаи ниҳоии беҳуҷҷат вуҷуд дошта наметавонад.
Ҳуҷҷатҳои истинодии интерактивӣ, чор SDK-и муштарӣ, қисми зиёди CLI ва чорчӯбаи провайдери Terraform ҳама аз ҳамон як мушаххасот тавлид мешаванд. Як манбаъ, бисёр маснуот, ҳамеша мувофиқ — шумо ҳеҷ гоҳ ҳуҷҷатеро, ки аз татбиқ дур шудааст, ҷустуҷӯ намекунед.
Нуқтаҳои ниҳоӣ дар зери /v1 бо сиёсати эълоншудаи кӯҳнашавӣ ва гузориши тағйирот ҷойгиранд. Пеш аз он ки чизе тағйир ёбад, ба шумо хаттӣ хабар дода мешавад, на ин ки онро аз сохтани ноком кашф кунед.
Санҷишҳои қарордодии татбиқ бар зидди мушаххасот ва линги OpenAPI дар ҳар як тағйирот иҷро мешаванд. Номувофиқатӣ байни код ва қарордод сохтмонро вайрон мекунад — бинобар ин, мушаххасоте, ки шумо аз он мизоҷи худро месозед, ҳамон мушаххасоте аст, ки сервер дар асл иҷро мекунад.
Ду роҳи ворид шудан, аммо як принсипи ягона дар паси онҳо. Ҳар кадомеро, ки истифода баред, ҳамон санҷишҳои иҷозат ва ҳамон ҷудокунии сатҳи пойгоҳи додаҳо татбиқ мешаванд.
Калидҳо ба монанди zdk_<mode>_<prefix>_<secret> ба назар мерасанд. Танҳо ҳеш-сигнали SHA-256-и махфӣ нигоҳ дошта мешавад — мо наметавонем калидро баъд аз судур ба шумо дубора нишон диҳем ва инчунин ҳеҷ касе, ки ба пойгоҳи додаҳои мо дастрасӣ пайдо мекунад, ин корро карда наметавонад. Калидҳо миқёсҳоро (scopes) доро мебошанд, метавонанд бекор карда шаванд ва ба ҷои як шахс, ба ҳар як ташкилот дода мешаванд.
Kalitҳои қуттии қум (sandbox) аз калитҳои истеҳсолӣ ҷудо буда, дар ҳолати қуттии қум кор мекунанд: пардохти воқеӣ ва таъминоти воқеӣ вуҷуд надорад. Санҷишҳои интегратсияи шумо метавонанд API-ро бидуни сарф кардани пул ё сохтани серверҳо фаъолона истифода баранд.
Сессияҳои корбар бо JWT-ҳои аз ҷониби Keycloak баровардашуда аутентификатсия мешаванд, ки бо калиди умумии realm санҷида мешаванд ва ба ҳамон объекти Principal мисли калиди API мувофиқат мекунанд. Нуқтаҳои ниҳоӣ (endpoints) ба калидҳои иҷозати муфассал ба монанди sites.create ё apikeys.manage назорат мекунанд, ки барои ҳар як созмон санҷида мешаванд — иҷозат дар як созмон ягон дастрасиро дар созмони дигари алоқаманд таъмин намекунад, гарчанде ки он ба созмонҳои дар зери он ҷойгиршуда тааллуқ дорад.
Ҳар як дархости муштарӣ дар доираи транзаксия бо доираи фарогирии созмони Postgres, ки аз субект гузошта шудааст, иҷро мешавад, бинобар ин ҷудосозӣ аз ҷониби пойгоҳи додаҳо таъмин карда мешавад, на аз ҷониби филтри ORM, ки касе метавонад онро фаромӯш кунад. Филтри queryset ҳанӯз ҳам ҳамчун хатти дуюми ҳимоят мавҷуд аст.
Сохтани API-е, ки дар README зебо намояд, осон аст, аммо дар зери трафики воқеӣ рафтори дуруст доштани он душвор аст. Инҳо ҳамон ҷузъҳое ҳастанд, ки мо ба хотири онҳо заҳмат кашидем, зеро маҳз ҳамин қисмҳо интегратсияҳоро соати сеи шаб вайрон мекунанд.
Як ҷузъиёте, ки қобили зикр аст, зеро он ба рафтори корҳои оммавӣ таъсир мерасонад: посухи 409 оид ба домени дубора ҷойгиршуда ба саволи «оё ин номи мизбон дар ин ҷо ҷойгир шудааст?» барои ҳар як иҷорагир ҷавоб медиҳад, ки ин як оркули номбаркунӣ ва хатари воқеии беномсозӣ нисбат ба Footprint-Free аст. Маҳдуд кардани сохтани сайт ислоҳи осон мебуд ва маҳсулоти таъминоти оммавиро тамоман вайрон мекард. Ба ҷои ин, танҳо кӯшишҳои радшудаи домени дубора бо буҷа мувофиқи принсип ҳисоб карда мешаванд. Сохтани бомуваффақият ҳеҷ гоҳ аз он ситонида намешавад — бинобар ин шумо метавонед дар давоми рӯз ба таври оммавӣ таъмин кунед ва тафтиш фавран қатъ мешавад.
Se base consumer-i якхела, барои се тарзи гуногуни кор.
Барои TypeScript, Python, PHP ва Go тавлид шуда, спецификатсияро пайгирӣ мекунад, то ки нуқтаи ниҳоии нав бе интизории оболочкаи дастисохт ба забони шумо ворид шавад.
Як сомонаи WordPress-ро таҳия кунед, онро дар реҷаи маҳаллӣ бе ягон воситаи насбшуда ба ғайр аз Node иҷро намоед ва онро паҳн кунед. Zinnector® лоиҳаи шуморо пеш аз паҳнкунӣ дар майдони таъиншуда санҷиш мекунад — версияи PHP, диск, шумораи файлҳо — ва пеш аз фиристодан, на баъд аз он огоҳӣ медиҳад. Инчунин он ворид мешавад, сомонаҳоро номбар мекунад, паҳн мекунад, доменҳо ва DNS-ро идора мекунад, хидматҳои почтаро мехонад, нусхаҳои эҳтиётӣ мегирад, фармонҳои WP-CLI-и иҷозатдодашударо иҷро мекунад, сабтҳоро (log-ҳо) пайгирӣ мекунад ва амалиёти оммавиро иҷро месозад. Ройгон, бо иҷозатномаи MIT ва дар асоси ҳамин API-и ҷамъиятӣ сохта шудааст.
Сайтҳо, доменҳо, сабтҳои DNS, паёмдонҳо ва нақшаҳоро ҳамчун инфрасохтор ба сифати код идора кунед. Фармони terraform apply мизбониро таъмин мекунад ва муҳитҳои шумо ба ҷои як силсила пахшкуниҳое, ки касе сабт накардааст, такроршаванда ва қобили баррасӣ мегарданд.
Ҳуҷҷатҳои тавлидшудаеро, ки метавонед аз браузер хонед ва даъват кунед, ва нуқтаҳои ниҳоии дақиқеро, ки сервер татбиқ мекунад, тавсиф мекунанд — зеро ҳарду аз як мушаххасот сарчашма мегиранд.
Дар паси платформа як устухони тасодуфии устувор қарор дорад: ҳар як тағирёбии ҳолат ҳодисаеро ба қуттии муомилотии берунӣ дар Postgres, ба таври атомӣ бо тағирёбии пойгоҳи додаҳо менависад ва як реле онро ба NATS JetStream нашр мекунад. Ҳодисаҳо дорои намуд ва версия мебошанд — site.deployed, order.paid, invoice.overdue, backup.completed, abuse.flagged, trial.ending ва боқимондаҳо.
Нуқтаи ниҳоиро ҳамчун WebhookSubscription сабт кунед ва намудҳои рӯйдодҳоеро, ки он қабул мекунад, интихоб намоед. Як ҷараён огоҳиҳо, таҳлилот, автоматизатсия ва интегратсияи шуморо таъмин мекунад — шумо ҳамон рӯйдодҳоеро истифода мебаред, ки мо истифода мебарем.
Ҳар як интиқол бо HMAC имзо шудааст, бинобар ин шумо метавонед пеш аз иҷрои ягон амал таъмин шавед, ки он аз ҷониби мо фиристода шудааст.
Интиқолҳои номуваффақ бо механизми ақибмонӣ такрор мешаванд ва ҳар як кӯшиш ҳамчун WebhookDelivery сабт мешавад. Шумо метавонед интиқолҳоро аз панели идоракунӣ тафтиш ва аз нав иҷро кунед, ба ҷои он ки ба дастгирии техникӣ паём фиристед ва пурсед, ки мо чӣ фиристодаем.
Пайнплайн қасдан ба ҷои вонамуд кардани ҳамагӣ-як-бор, на камтар-аз-як-бор сохта шудааст. Релее, ки дар миёнаи нашр аз кор мемонад, муҳлати љиораи иддиоаш ба охир мерасад ва рӯйдодҳояш дубора нашр мешаванд. Бо истифода аз дубликатсионии envelope id, истеъмолкунандаи шумо аз рӯи сохтор дуруст кор мекунад.
API танҳо нисфи достони таҳиякунанда аст. Нисфи дигари он интиқол ва нашр аст.
Мо платформаро ҳамчун сервери MCP-и мизбонишуда пешниҳод мекунем: мутобиқсози борики протокол болои API-и муҳаррик, ки каталоги амалҳои якхела, RBAC ва пайraҳаи аудитҳоро истифода мебарад. Claude Code, Cursor, ChatGPT, Claude Desktop ё ҳар муштарии дорои қобилияти MCP-ро як маротиба пайваст кунед ва ҳар қобилияте, ки мо ба API илова мекунем, ба таври худкор барои он дастрас мегардад.
Агент се чизро мегирад: Абзорҳо (ҳамон нуқтаҳои ниҳоии API, бидуни мантиқи мувозӣ барои дур шудан аз ҳадаф), Захираҳо (тандурустии сомона танҳо барои хондан, танзимот, журналҳои охирин, метрикаҳо, давомнокии кор ва мақолаҳои пойгоҳи дониш, то ки он пеш аз амал кардан бо маълумоти воқеӣ ташхис кунад) ва Дархостҳо (қолабҳои ҷараёни кори нашршуда, ба монанди "ин сомонаро ташхис кунед" ё "муҳоҷиратро омода кунед").
Бехатарӣ низ ҳамон ҳикояи аутентификатсия аст: OAuth 2.1, токенҳои ба созмони шумо вобаста ва иҷозатҳои RBAC бо амнияти сатҳи сатр, ки татбиқ карда шудаанд, маҳдуд ва барои ҳар як абзор бозхондшаванда, қуттии қум (sandbox) аз истеҳсол ҷудо карда шудааст. Амалҳои вайронкунанда — нест кардан, боздоштан, ҳисобдорӣ, хароҷоти калон — тасдиқи мустақим ё сиёсати тасдиқи инсонро талаб мекунанд. Маҳдудиятҳои суръат ва ҳадди хароҷот амалҳои пулакии аз ҷониби AI оғозшударо маҳдуд мекунанд ва ҳар یک занги MCP бо шахсият, абзор, далелҳо ва натиҷа ба қайд гирифта мешавад.
Мо ба ҷои муттаҳид кардани ҳар як барнома ба таври алоҳида, протоколро дастгирӣ мекунем, ки ин маънои онро дорад, ки интихоби абзорҳои сунъии зеҳнии шумо метавонад тағйир ёбад, бе он ки интегратсияи мизбонии шумо бо он тағйир ёбад.
Бале — ин ҳамон API-и муҳаррик аст, ки нашр ва мустаҳкам карда шудааст. Панели идоракунӣ, консоли админ, CLI, таъминкунандаи Terraform, сервери MCP ва вебхукҳо ҳама истеъмолкунандагони як рӯизамин ҳастанд, аз ин рӯ API аз панел қафо намемонад.
Bale. Kalitҳои қуттии қум (sandbox) ҷудо аз калитҳои истеҳсолӣ дода мешаванд ва дар реҷаи санҷишӣ кор мекунанд: бе ҳисобкунии воқеии маблағ ва бе таъминоти воқеӣ. Системаи CI-и худро ба маълумоти ҳисоботии қуттии қум равона кунед ва давраи пурраи дархосту ҷавобро бехатар санҷида бароед.
Дар дархости POST-и худ Idempotency-Key фиристед. Сабти такрорӣ ба ҷои сатри дарунсохт ҳангоми содиршавӣ (commit) навишта мешавад, бинобар ин кӯшиши дубора ҳеҷ гоҳ муваффақияти захирашударо барои сатре, ки дар асл содир нашудааст, такрор намекунад ва дархости ноком қулфи худро фавран озод мекунад, то кӯшиши ислоҳшудаи шумо боздошта нашавад. Исоли вебхук аз рӯи тарроҳӣ ҳадди аққал як маротиба аст — онро аз рӯи шиносаи конверт (envelope id) дар тарафи худ дубора тоза кунед.
Imruz na. Kalitҳои API барои ҳар як созмон ба таври алоҳида дода мешаванд, аз ин рӯ як интегратсия, ки якчанд созмони муштариро дар бар мегирад, барои ҳар кадоми онҳо калити худро дорад. Иҷозатҳо инчунин барои субъектҳои корбарӣ ба таври алоҳида барои ҳар созмон санҷида мешаванд: доштани sites.create дар як созмон ягон дастрасиро дар созмони дигари алоқаманд намедиҳад, гарчанде ки он ба созмонҳои зертобеи он тааллуқ дорад. Ин бо мақсад карда шудааст — он калити муҳофизатнашударо бо созмони худ ва зерсозмонҳои он маҳдуд мекунад, на тамоми платформаро.
Нақши таҳиягар хондани созмон, идоракунии калидҳои API, дидан ва эҷоди сайтҳо, бозоғозии онҳо, тоза кардани кэши онҳо, инчунин дидан ва ҷавоб додан ба чиптаҳоро дар бар мегирад. Он қасдан идоракунии ҳисобдорӣ (биллинг)-ро истисно мекунад. Дар хотир доред, ки иҷозатҳои ҷойгиркунӣ (deploy) ва интиқол ба сомонаи корӣ (push-to-live) қисми он нестанд — агар ба узви гурӯҳ инҳо лозим бошанд, нақшеро таъин кунед, ки онҳоро дар бар мегирад, на ин ки фикр кунед васеътарин нақши техникӣ Таҳиягар аст.
Иrsol-moli bo kofkard takror meshavad va har yak kӯshish hamчуn WebhookDelivery sabt meshavad, ki onro ba nazar giriftan mumkin ast. Dar qismi bolo, hodisalar ba outbox-i transaktsionӣ dar daxili transaktsiyai yakxudai bazai додаҳо navšta meshavad, az in rӯ ҳangomi dastrush nabudani iste'molkunanda heҷ chiz gum nameshavad — iste'molkunandai kornafta qof meshamonad, vale heҷ goh iste'hsolkunandaro vaqf nameshavad va shumo metavoned pas az bargashtan irsolhoro az panel-i idora takror kuned.
Оғози озмоиши 14-рӯзаи ройгони Footprint-Free Hosting — бидуни маълумоти пардохт, то 5 сайт. Сатҳҳои پaid-и Footprint-Free аз $6/моҳ барои PBN 5 оғоз мешаванд. Ҳар як нақша дорои кафолати бозгашти маблағ дар давоми 30 рӯз, муҳоҷирати ройгон ва набудани банди фурӯшанда мебошад.
API-и аввал-спесификатсия, SDK-ҳои тавлидшуда, CLI, таъминкунандаи Terraform, вебхукҳои имзошуда ва сервери MCP — дар мизбоние, ки мо барои зиёда аз 650,000 сайт дар саросари ҷаҳон сохтаем. Дар озмоиши 14-рӯзаи бидуни корти бонкӣ ва бидуни маълумоти пардохт оғоз кунед.
Оғози ройгон