Барои таҳиягарон
Zinn Digital® як платформаи API-first мебошад. Ҳамон API-и муҳаррике, ки панели идоракунии моро таъмин мекунад, ҳамон чизест, ки шумо дастрас мекунед — бо версияҳо, дар асоси мушаххасот ва 100% ҳуҷҷатгузоришуда ҳангоми сохтан, бо SDK-ҳои тавлидшуда, CLI, таъминкунандаи Terraform, вебҳукҳои имзошуда ва сервери MCP дар заминаи он. Шумо барои кор чиро истифода баред ҳам — терминал, қубур, файли ҳолат ё агенти AI — платформа ба он посух медиҳад.
Аксари мизбонҳо API-ро баъдан ба панели идоракунӣ пайваст мекунанд ва ин эҳсос мешавад — нисфи имконоти панел ҳеҷ гоҳ дастрас намегарданд. Мо бо тарзи дигар сохтем. Панели идоракунӣ, консили мудир, CLI, таъминкунандаи Terraform, сервери MCP ва ҳамгироиҳои шахсии шумо ҳама аз як API-и муҳаррик истифода мебаранд. Агар шумо инро дар панел иҷро карда тавонед, шумо метавонед онро дар код низ иҷро кунед.
Мушаххасоти OpenAPI манбаи ягонаи ҳақиқат аст ва ҳеҷ як нуқтаи ниҳоӣ (endpoint) то он даме, ки дар ин мушаххасот набошад, ба кор дароварда намешавад. Маҳз ҳамин қоидаи ягона боис мегардад, ки API-и оммавӣ на баъдтар, балки ҳангоми сохтан пурра ҳуҷҷатгузорӣ шавад — ҳеҷ як гӯшаи беҳуҷҷат мавҷуд нест, зеро нуқтаи ниҳоии беҳуҷҷат наметавонад вуҷуд дошта бошад.
Ҳуҷҷатҳои маълумотномавии интерактивӣ, чор SDK-и мизоҷ, қисми зиёди CLI ва сохтори провайдери Terraform ҳама аз ҳамон як мушаххасот тавлид мешаванд. Як сарчашма, маводҳои зиёд, ҳамеша ҳамоҳанг — шумо ҳеҷ гоҳ ҳуҷҷатеро, ки аз татбиқ дур шудааст, ҷустуҷӯ намекунед.
Нуқтаҳои ниҳоӣ дар зери /v1 бо сиёсати нашршудаи бекоркунӣ ва журнали тағйирот ҷойгиранд. Пеш аз ворид шудани ягон тағйирот, ба ҷои огоҳ шудан тавассути нокомии сохт, ба шумо хаттӣ хабар дода мешавад.
Санҷишҳои шартномавии татбиқ ба мушаххасот ва санҷиши сабти OpenAPI дар ҳар як тағйирот иҷро мешаванд. Ихтилоф байни рамз ва шартнома боиси нокомии васлкунӣ мегардад — бинобар ин мушаххасоте, ки шумо аз он муштарии худро месозед, мушаххасоте мебошад, ки сервер воқеан риоя мекунад.
Ду роҳи вуруд, пушти онҳо як принсипи ягона. Кадомашро истифода баред ҳам, ҳамон санҷишҳои иҷозат ва ҳамон ҷудосозӣ дар сатҳи пойгоҳи додаҳо татбиқ мешаванд.
Калидҳо ба zdk_<mode>_<prefix>_<secret> монанданд. Танҳо ҳаши SHA-256-и қисми махфӣ захира карда мешавад — мо наметавонем пас аз судур калидро дубора ба шумо нишон диҳем ва инчунин ҳеҷ касе, ки ба пойгоҳи додаҳои мо дастрасӣ пайдо мекунад, наметавонад ин корро кунад. Калидҳо доираи амал доранд, метавонанд бекор карда шаванд ва на ба ҳар як шахс, балки ба ҳар як созмон дода мешаванд.
Калидҳои санҷишгоҳ аз калидҳои истеҳсолӣ ҷудо мебошанд ва дар реҷаи санҷишгоҳ кор мекунанд: бидуни пардохти воқеӣ, бидуни ҷудокунии воқеии захираҳо. Санҷишҳои ҳамгироии шумо метавонанд бе сарфи маблағ ва бе сохтани серверҳо API-ро мавриди бори шадид қарор диҳанд.
Сессияҳои корбар бо JWT-ҳои аз ҷониби Keycloak додашуда, ки нисбат ба калиди оммавии realm тасдиқ шудаанд, аутентификатсия мешаванд ва ба ҳамон объекти Principal табдил меёбанд, ки калиди API мекунад. Нуқтаҳои ниҳоӣ аз рӯи калидҳои иҷозати дақиқ ба мисли sites.create ё apikeys.manage, ки барои ҳар як ташкилот санҷида мешаванд, маҳдуд карда мешаванд — иҷозат дар як ташкилот дар ташкилоти дигари ба он алоқаманднабуда ҳеҷ гуна дастрасӣ намедиҳад, гарчанде ки он ба ташкилотҳои зертобеи он татбиқ мегардад.
Ҳар як дархости иҷорагир дар як транзаксия бо доираи созмони Postgres, ки аз асосӣ таъйин шудааст, иҷро мешавад, бинобар ин ҷудокунӣ аз ҷониби пойгоҳи додаҳо ба амал бароварда мешавад, на аз ҷониби филтри ORM, ки касе метавонад онро фаромӯш кунад. Филтри queryset то ҳол ҳамчун муҳофизати амиқ вуҷуд дорад.
Намуди зоҳирии API-ро дар README зебо кардан осон аст, аммо таъмини кори дурусти он зери трафики воқеӣ мушкил мебошад. Мо маҳз барои ҳамин қисмҳо заҳмат кашидем, зеро инҳо қисмҳое мебошанд, ки пайвастшавиҳоро дар соати сеи шаб аз кор мебароранд.
Як ҷузъиёте, ки бояд зикр кард, зеро он тарзи кори амалиёти оммавиро муайян мекунад: хатои 409 дар мавриди домени такрорӣ ба саволи «оё ин номи мизбон дар ин ҷо ҷойгир шудааст?» барои ҳар як иҷорагир посух медиҳад, ки ин як оракули башуморгирӣ ва хатари воқеии беномнамоӣ бар зидди Footprint-Free мебошад. Маҳдуд кардани суръати эҷоди сомона роҳи осони танбалона мебуд ва маҳсулоти таъминоти оммавиро комилан аз кор мебаровард. Ба ҷои ин, танҳо кӯшишҳои радшудаи доменҳои такрорӣ барои ҳар як субъекти асосӣ маҳдуд карда мешаванд. Эҷодҳои бобарор ҳеҷ гоҳ аз ин ҳисоб кам карда намешаванд — бинобар ин шумо метавонед тамоми рӯз ба таври оммавӣ захираҳоро ҷудо кунед ва санҷишҳои ғайриқонунӣ қариб фавран қатъ мегарданд.
Се истеъмолкунандаи як хусусият, барои се тарзи гуногуни кор.
Барои 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 сабт мегардад. Шумо метавонед ба ҷои фиристодани паёми электронӣ ба хадамоти дастгирӣ барои фаҳмидани он ки чӣ фиристода будем, интиқолҳоро мустақиман аз панели идоракунӣ тафтиш кунед ва дубора иҷро намоед.
Интиқолгоҳ қасдан намуди на камтар аз як бор буда, вонамуди расо як бор буданро надорад. Реле, ки дар миёнаи интишор қатъ мегардад, муҳлати даъвои он ба охир мерасад ва рӯйдодҳояш дубора интишор мешаванд. Дар envelope id беҳамтокуниро иҷро намоед ва истеъмолкунандаи шумо аз рӯи сохт дуруст мебошад.
API танҳо нисфи қиссаи як барноманавис аст. Нисфи дигар ин ба кор андохтани он мебошад.
API танҳо як дар аст. Инҳо чаҳор дари дигар мебошанд ва ҳар яки онҳо ба ҷои фурӯхта шудан ҳамчун сатҳи таҳиягар, ба нақша дохил карда шудаанд.
VS Code дар браузер, ки аз саҳифаи сомона дар панели идоракунӣ боз мешавад, файлҳои воқеии он сомонаро бо git-и дарунсохт ва тамоми муҳаррир дар дохили ҳамон ҷудокунии CageFS, ки дастрасии SFTP-и шумо дорад, таҳрир мекунад. Он сомонаи ЗИНДА-ро таҳрир мекунад — дар ин миён нусхаи озмоишӣ нест, бинобар ин файле, ки шумо захира мекунед, ҳамон лаҳзаи навишта шуданаш дастраси ҳамагон мегардад, гарчанде файли статикӣ метавонад то чор соат аз кэши CDN пешниҳод шавад.
Ройгон, бо иҷозатномаи MIT ва дар асоси ҳамин API-и оммавӣ сохта шудааст. Сохтори сайти WordPress-ро омода кунед, онро дар компютери худ оғоз намоед, мутобиқати онро бо ҷойи таъйиншуда пешакӣ санҷед — версияи PHP, диск, шумораи файлҳо — ва ба кор баред. Node 24 ё навтар талаб карда мешавад.
Як феҳристи абзорҳо, то муштарии зеҳни сунъӣ, ки шумо аллакай истифода мебаред, тавонад дар сайтҳои шумо тавассути ҳамон API ва ҳамон иҷозатҳое, ки панели идоракунӣ истифода мебарад, кор кунад. Ҳамон сервере, ки муштарии худи шумо ба он пайваст мешавад, ба муҳаррири веб пайваст аст. Танҳо барои хондан, то даме ки шумо тартиби дигареро муайян накунед.
Барои кори муштарӣ гузарвожаи шумо лозим нест. Касеро тавассути суроғаи почтаи электронӣ даъват кунед ва ӯ маҳз ба як сайт дастрасӣ пайдо мекунад: ӯ зери номи худ бо нақши бинанда, муҳаррир ё мудир ворид мешавад ва ҳар як сайти дигар қабл аз иҷрои ягон коркардкунанда посухи 404 медиҳад — ин сиёсати амнияти сатҳи сатри Postgres ва садди сатҳи дархост мебошад, на танҳо як санҷиш. Соҳиби ҳисоб онро бо як клик медиҳад ва бекор мекунад, ки аз дархости навбатии онҳо эътибор пайдо мекунад.
Мо платформаро ҳамчун сервери мизбоншудаи MCP пешниҳод мекунем: адаптери тунуки протокол бар болои API-и муҳаррик, ки ҳамон феҳристи амалҳо, RBAC ва таърихи аудитро аз нав истифода мебарад. Claude Code, Cursor, ChatGPT, Claude Desktop ё дигар муштарии дорои қобилияти MCP-ро як маротиба пайваст кунед, ва ҳар як қобилияти ба API иловакардаи мо ба таври худкор барои он дастрас мегардад.
Агент се чизро дастрас мекунад: Tools (ҳамон нуқтаҳои ниҳоии API, ҳеҷ мантиқи мувозӣ барои инҳироф надорад), Resources (ҳолати сайт танҳо барои хондан, танзимот, сабтҳои охирин, нишондиҳандаҳо, вақти корӣ ва мақолаҳои пойгоҳи дониш, то пеш аз амал кардан бо додаҳои воқеӣ ташхис кунад) ва Prompts (қолибҳои нашршудаи раванди корӣ, ба монанди "diagnose this site" ё "prepare a migration").
Бехатарӣ ҳамон ҳикояи аутентификатсия аст: OAuth 2.1, токенҳои ба созмони шумо пайвастшуда ва иҷозатҳои RBAC бо амнияти сатҳи сатр татбиқшуда, дорои доираи муайян ва бекоршаванда барои ҳар як абзор, муҳити санҷишӣ (sandbox) аз муҳити аслӣ (production) ҷудошуда. Амалҳои харобиовар — нест кардан, боздоштан, ҳисобдорӣ, хароҷоти калон — тасдиқи возеҳ ё сиёсати тасдиқи инсониро талаб мекунанд. Маҳдудиятҳои суръат ва сатҳи ниҳоии хароҷот амалҳои пулакии тавассути AI оғозшударо маҳдуд месозанд ва ҳар як дархости MCP бо нишон додани ҳувият, абзор, далелҳо ва натиҷа ба қайд гирифта мешавад.
Мо ба ҷои пайваст кардани ҳар як барнома ба таври алоҳида, аз худи протокол пуштибонӣ мекунем, ки ин маънои онро дорад, ки интихоби абзорҳои зеҳни сунъии шумо метавонад бидуни тағйир ёфтани ҳамгироии мизбонии шумо тағйир ёбад.
Ҳа — ин ҳамон API-и муҳаррик аст, ки нашр ва мустаҳкам карда шудааст. Панели идоракунӣ, консоли мудир, CLI, таъминкунандаи Terraform, сервери MCP ва вебҳукҳо ҳама истеъмолкунандагони як сатҳ мебошанд, бинобар ин API аз панел қафо намемонад.
Ҳа. Калидҳои санҷишгоҳ аз калидҳои истеҳсолӣ ҷудо дода мешаванд ва дар ҳолати санҷишӣ кор мекунанд: бе ҳисоббаробаркунии воқеӣ ва бе таъминоти воқеӣ. CI-и худро ба маълумоти эътимодномаи санҷишгоҳ равона кунед ва давраи пурраи дархосту посухро бехатар санҷед.
Дар дархости POST-и худ Idempotency-Key-ро фиристед. Сабти такрористеҳсолкунӣ на ба таври ҳамзамон (inline), балки ҳангоми тасдиқкунӣ (commit) навишта мешавад, бинобар ин кӯшиши такрорӣ ҳеҷ гоҳ наметавонад муваффақияти кэшшударо барои сатре, ки воқеан тасдиқ нашудааст, бозпахш кунад, ва дархосте, ки нобарор мешавад, қулфи худро фавран озод мекунад, то кӯшиши такрории ислоҳшудаи шумо ба таъхир наафтад. Интиқоли вебҳук (webhook) аз рӯи тарҳ ҳадди аққал як маротиба (at-least-once) анҷом меёбад — такрорёбиро дар асоси envelope id дар тарафи худ бартараф кунед.
На имрӯз. Калидҳои API барои ҳар як созмон алоҳида дода мешаванд, бинобар ин ҳамгироие, ки якчанд созмонҳои муштариро дар бар мегирад, барои ҳар яки онҳо калид дорад. Иҷозатҳо инчунин барои ҳар як созмон барои истифодабарандагони асосӣ санҷида мешаванд: доштани sites.create дар як созмон дар як созмони алоҳида ва ба он иртиботнадошта дастрасӣ намедиҳад, гарчанде ки он ба созмонҳои зертобеи он татбиқ мешавад. Ин қасдан аст — он калиди осебдидаро ба худи ҳамон созмон ва зерсозмонҳои тобеи он маҳдуд мекунад, на ба тамоми платформа.
Нақши dev хондани маълумоти созмон, идораи калидҳои API, дидан ва сохтани сомонаҳо, бозоғозии онҳо, поксозии ҳофизаи ниҳонии (cache) онҳо ва дидани дархостҳову ҷавоб додан ба онҳоро дар бар мегирад. Он дидаву дониста идораи пардохтҳоро истисно мекунад. Дар хотир доред, ки иҷозатҳои роҳандозӣ (deploy) ва нашри зинда (push-to-live) ҷузъи он нестанд — агар аъзои даста ба онҳо ниёз дошта бошад, ба ҷои он ки Developer нақши фарогиртарини техникӣ пиндошта шавад, ба ӯ нақшеро вогузоред, ки онҳоро дорад.
Интиқолҳо бо афзоиши фосилаи вақт такроран кӯшиш карда мешаванд ва ҳар як кӯшиш ҳамчун WebhookDelivery сабт мегардад, ки шумо метавонед онро тафтиш кунед. Дар қисми болооб, ҳодисаҳо дар ҳамон транзаксияи пойгоҳи додаҳо ҳамчун худи тағйирот ба қуттии содиротии транзаксионӣ навишта мешаванд, бинобар ин, ҳангоми дастнорас будани истеъмолкунанда ҳеҷ чиз гум намешавад — истеъмолкунандаи аз кор монда танҳо қафо мемонад, вале ҳеҷ гоҳ истеҳсолкунандаро аз кор намебарорад ва шумо метавонед пас аз баргаштан интиқолҳоро аз панели идоракунӣ аз нав фаъол намоед.
Бо давраи озмоишии 14-рӯзаи бекортии хостинги Footprint-Free оғоз кунед — бидуни маълумоти пардохт, то 5 сайт. Сатҳҳои пулакии Footprint-Free барои PBN 5 аз $6/моҳ оғоз мешаванд. Ҳар як нақша кафолати 30-рӯзаи баргардонидани маблағ, кӯчонидани ройгон ва озодӣ аз вобастагӣ ба як таъминкунанда дорад.
API-и ба тавсиф асосёфта, SDK-ҳои тавлидшуда, як CLI, провайдери Terraform, вебҳукҳои имзошуда ва сервери MCP — дар хостинге, ки мо барои беш аз 700 000 сомона дар саросари ҷаҳон сохтаем. Бо озмоиши 14-рӯзаи бидуни корт ва бе маълумоти пардохт оғоз намоед.
Ройгон оғоз кунедҲар кадоме аз ин плагинҳо сайти WordPress-и шуморо ба сервери MCP мубаддал мекунад, то ки Claude, Cursor, VS Code ва дигар ёрдамчиёни сунъӣ тавонанд дар он кори воқеӣ анҷом диҳанд, бо ҳисоби шумо ворид шуда ва бо маҳдудияти ҳуқуқҳои шумо.