Don masu haɓakawa
Zinn Digital® dandamali ne da aka gina bisa tsarin API-farko. Wannan API ɗin injin da ke tafiyar da allon sarrafawarmu shi ne wanda kuke samu — mai lambobin fasali daban-daban, mai bin ka'idar bayani da farko kuma an yi cikakken bayaninsa 100% a lokacin ginawa, tare da samar da SDKs, CLI, mai samar da sabis na Terraform, sa hannun webhooks da kuma uwar garken MCP a kansa. Duk abin da kuke amfani da shi wajen aiki — na'urar tasha, hanyar sarrafa bayanai, fayil ɗin yanayi ko wakilin AI — dandamalin yana karɓar umarninsa.
Yawancin masu bayar da sabis na hosting suna manne API a jikin control panel bayan komai ya kammala, kuma hakan yana bayyana karara — rabin abubuwan da ke cikin panel ɗin ba sa taɓa fitowa. Mu kuma mun gina shi ta wata hanyar daban. Dashboard, admin console, CLI, mai bada sabis na Terraform, sabar MCP da kuma haɗin-gwiwarku na kanku duk suna amfani da injin API ɗaya ne. Idan za ku iya yin sa a cikin panel, za ku iya yin sa a cikin lamba (code).
Bayanin ƙayyadaddun OpenAPI shi ne tushen gaskiya, kuma babu wata ma'asumar da ake fitarwa sai dai idan tana cikin bayanin. Wannan ƙa'ida guda ɗaya ita ce ke sa API na jama'a ya kasance a rubuce sosai a lokacin ginawa maimakon a nan gaba — babu wani lungu da ba a rubuta ba, saboda ma'asumar da ba a rubuta ba ba za ta iya wanzuwa ba.
Takardun bincike masu ma'amala, SDK guda huɗu na abokin ciniki, mafi yawan CLI da kuma tsarin samar da Terraform duk ana samar da su ne daga wannan ƙayyadadden bayanin guda ɗaya. Tushe ɗaya, kayayyaki masu yawa, koyaushe a haɗe — ba za ku taɓa bin takardar da ta kauce daga ainihin aikin ba.
Wuraren ƙarshe suna ƙarƙashin /v1 tare da manufar daina amfani da aka buga da kuma bayanin canje-canje. Ana sanar da ku a rubuce kafin wani abu ya canza, maimakon gano hakan daga ginin da ya gaza.
Gwajin yarjejeniya na aiki-da-ƙa'ida da kuma binciken OpenAPI na gudana a kowane canji. Saɓani tsakanin lambar sirri (code) da yarjejeniyar na sa tsarin haɗawa (build) ya fāɗi — don haka ƙa'idar da kuke ƙirƙirar abokin cinikinku (client) daga gare ta ita ce ƙa'idar da uwar garken (server) ke amfani da ita a zahiri.
Hanyoyi biyu na shiga, manufa ɗaya tilo a bayan su. Ko wanne kuka yi amfani da shi, ana amfani da binciken izini iri ɗaya da kuma keɓewa iri ɗaya a matakin rumbun adana bayanai.
Maballan suna kama da zdk_<mode>_<prefix>_<secret>. Hash na SHA-256 na sirrin ne kawai ake adanawa — ba za mu iya sake nuna muku mabulli ba bayan an fitar da shi, kuma babu wanda ya sami damar shiga rumbun adana bayananmu da zai iya yin hakan. Maballai suna ɗauke da iyakoki, ana iya soke su, kuma ana ba da su ga kowace ƙungiya maimakon kowane mutum.
Mabuɗan Sandbox sun bambanta da na production kuma suna aiki ne a yanayin sandbox: babu ainihin biyan kuɗi, babu ainihin samar da kayan aiki. Gwaje-gwajen haɗin ku na iya tura buƙatu masu yawa zuwa API ba tare da kashe kuɗi ko gina sabar ba.
Zaman masu amfani na tabbatar da sahihanci ta hanyar JWTs da Keycloak ta bayar, wanda aka tantance da maɓallin jama'a na realm, kuma suna komawa zuwa ainihin abin Principal guda ɗaya kamar yadda maɓallin API key yake yi. Endpoints suna iyakance shiga ta hanyar maɓallan izini daki-daki kamar sites.create ko apikeys.manage, waɗanda ake dubawa a kowace ƙungiya — izini a wata ƙungiya ɗaya ba ya ba da damar shiga a wata ƙungiyar daban da ba ta da alaƙa da ita, kodayake yana aiki ga ƙungiyoyin da ke ƙarƙashinta.
Kowace buƙata ta mai haya tana gudana a cikin ciniki tare da saitin iyakokin ƙungiyar Postgres daga asali, don haka ɗakunan ajiya ne ke tabbatar da keɓancewa, ba tacewar ORM da wani zai iya mantawa ba. Tacewar queryset har yanzu tana nan a matsayin tsaro mai zurfi.
Yana da sauƙi a sa API ya yi kyau a cikin README kuma yana da wuya a sa ya yi aiki yadda ya kamata a ƙarƙashin ainihin cunkoson bayanai. Waɗannan su ne ɓangarorin da muka yi aiki tuƙuru a kansu, domin su ne ɓangarorin da ke lalata haɗewar manhajoji da ƙarfe uku na dare.
Wani cikakken bayani da ya kamata a lura da shi, saboda yana tsara yadda aikin da aka yi da yawa yake aiki: kuskuren 409 a kan yankin da aka maimaita yana amsa tambayar "an karɓi bakuncin wannan sunan masaukin a nan?" ga kowane mai haya, wanda ke zama oracle na lissafawa da kuma haɗarin ɓatar da ɓoye-suna na gaske ga Footprint-Free. Takaita saurin ƙirƙirar rukunin yanar gizo zai zama gyara na lalaci kuma zai lalata samfurin samarwa da yawa gaba ɗaya. Maimakon haka, ƙoƙarin da aka ƙi na yankin da aka maimaita ne kawai ake sanya wa kasafin kuɗi, ga kowane mai asusun. Ba a taɓa cajin ƙirƙira mai nasara akan sa ba — don haka kuna iya samarwa da yawa tsawon yini, kuma bincike yana mutuwa nan take.
Masu amfani guda uku na ƙayyadaddun bayanai ɗaya, don hanyoyi guda uku daban-daban na aiki.
An ƙirƙira shi don TypeScript, Python, PHP da Go, yana bin ƙa'idodin don sabon endpoint ya iso a cikin yarenku ba tare da jiran wrapper da aka rubuta da hannu ba.
Gina tsarin rukunin yanar gizo na WordPress, gudanar da shi a kan na'urarku ba tare da an shigar da komai ba sai Node, sannan ku tura shi. Zinnector® yana duba aikinku tun da wuri dangane da ma'adanar da kuke shirin turawa zuwa gare ta — sigar PHP, faifai, adadin fayiloli — kuma yana ba da gargaɗi kafin ku tura maimakon bayan kun tura. Hakanan yana shiga ciki, yana lissafa rukunonin yanar gizo, yana turawa, yana sarrafa yankuna da DNS, yana karanta ayyukan wasiƙa, yana ɗaukar kwafin ajiya, yana gudanar da WP-CLI da aka amince da su, yana bibiyar rajistar ayyuka, kuma yana aiwatar da ayyuka masu yawa lokaci ɗaya. Kyauta ne, mai lasisin MIT, kuma an gina shi a kan wannan manhajar API ɗin ta jama'a.
Sarrafa shafuka, yankuna, bayanan DNS, akwatunan saƙo da tsare-tsare a matsayin kayan aiki a matsayin lamba (infrastructure as code). terraform apply yana samar da hosting, kuma muhallanku suna zama masu iya sake haifarwa da za a iya dubawa a maimakon jerin dannawa da babu wanda ya rubuta.
Takaddun da aka samar waɗanda za ku iya karantawa kuma ku kira daga burawza, suna bayyana ainihin madogaran da uwar garken ke aiwatarwa — saboda duka biyun sun fito ne daga ƙayyadaddun bayanai guda ɗaya.
A bayan tsarin akwai jigon al'amura mai dorewa: kowane canjin yanayi yana rubuta al'amari a cikin akwatin aikawa na hada-hadar kasuwanci a Postgres, a dunkule tare da canjin ma'ajiyar bayanai, kuma wani relay yana buga shi zuwa NATS JetStream. Al'amura suna da rabe-rabe da nau'o'i — site.deployed, order.paid, invoice.overdue, backup.completed, abuse.flagged, trial.ending da sauran su.
Yi rijistar endpoint a matsayin WebhookSubscription kuma ka zaɓi nau'ikan abubuwan da zai karɓa. Rafi guda ɗaya yana ciyar da sanarwa, bincike, sarrafa kansa da kuma haɗin gwiwarka baki ɗaya — kana amfani da irin abubuwan da muke amfani da su.
Kowace isarwa an sanya mata hannu da HMAC domin ku iya tabbatar da cewa daga gare mu ta fito kafin ku ɗauki mataki a kanta.
Ana sake gwada isar da sakonnin da suka gaza tare da jinkiri, kuma ana yin rikodin kowane yunƙuri a matsayin WebhookDelivery. Za ku iya dubawa tare da sake tura sakonnin daga allon sarrafawa maimakon aika imel zuwa ga sashen tallafi kuna tambayar abin da muka aika.
Tsarar aikin tana aiki ne da gangan a matsayin akalla-sau-daya (at-least-once) maimakon nuna cewa tana aiki a matsayin daidai-sau-daya (exactly-once). Wata relay da ta mutu a tsakiyar wallafawa za a bar wa'adin jinginar ta ya kare sannan a sake wallafa al'amuranta. Cire kwafin bayanai ta hanyar amfani da envelope id kuma mai karbar bayanan ku zai kasance daidai ta hanyar gini.
API rabin labarin mai haɓakawa ne kawai. Sauran rabin shine kaddamarwa.
API kofa ɗaya ce. Waɗannan su ne sauran huɗun, kuma an haɗa kowannensu a cikin tsarin maimakon a sayar da shi a matsayin matakin masu haɓakawa.
VS Code a cikin burawza, wanda aka buɗe daga shafin rukunin yanar gizon a cikin allon sarrafawa (dashboard), yana gyara ainihin fayilolin wannan rukunin tare da ginanniyar git da kuma dukkan editan a cikin keɓantaccen gidan yari (jail) na CageFS ɗaya da damar ku ta SFTP. Yana gyara rukunin yanar gizo na KAI TSAYE (LIVE) — babu kwafin gwaji (staging copy) a tsakani, don haka fayil ɗin da kuka ajiye yana bayyana a bainar jama'a da zarar an rubuta shi, kodayake fayil ɗin da ba ya canzawa (static file) na iya ci gaba da aiki daga ma'ajiyar CDN har zuwa sa'o'i huɗu.
Kyauta, mai lasisin MIT kuma an gina shi akan wannan API ɗin na jama'a. Gina tsarin rukunin yanar gizo na WordPress, kunna shi a kwamfutarka, duba shi kafin aikawa dangane da ramin da kake shirin turawa zuwa gare shi — nau'in PHP, faifai, adadin fayil — sannan ka tura. Yana buƙatar Node 24 ko sabo.
Kundi ɗaya na kayan aiki, domin abokin ciniki na AI da kuke amfani da shi a yanzu ya iya aiki a kan shafukanku ta hanyar API iri ɗaya da kuma izini iri ɗaya da allon sarrafawa ke amfani da su. Sabar ɗaya da abokin cinikin ku ke haɗawa da ita ita ce aka haɗa da editan gidan yanar gizo. Karatun kawai har sai kun faɗi akasin haka.
Aikin abokin ciniki baya buƙatar kalmar sirrinku. Gayyaci wani ta adireshin imel kuma zai sami shafi ɗaya daidai: za su shiga da kansu, tare da matsayin mai kallo, edita ko manaja, kuma kowane shafi daban zai amsa da 404 kafin kowane mai sarrafawa ya yi aiki — manufar tsaro ta matakin jeri ta Postgres da kuma katanga ta matakin buƙata, ba duba ɗaya kawai ba. Mai asusun yana bayarwa kuma yana soke shi da dannawa ɗaya, wanda zai yi aiki a buƙatarsu ta gaba.
Muna fitar da dandalin a matsayin uwar garken MCP da aka karɓi baƙuncinta: wata siririyar adaftar ƙa'idar aiki a kan API ɗin injin wacce ke sake amfani da jerin ayyuka iri ɗaya, RBAC da kuma sawun binciken kuɗi. Haɗa Claude Code, Cursor, ChatGPT, Claude Desktop ko kowane abokin ciniki mai ikon sarrafa MCP sau ɗaya, kuma duk wata sabuwar dama da muka ƙara a API ɗin za ta zama mai sauƙin amfani gare shi kai tsaye.
Wakilin yana samun abubuwa guda uku: Tools (ainihin API endpoints iri ɗaya, babu wata dabammin dabara da za ta karkace), Resources (lafiyar shafi da ake karantawa kawai, config, sabbin logs, metrics, uptime da maƙalun KB, domin ya binciko matsala da ainihin bayanai kafin ya ɗauki mataki) da kuma Prompts (samfuran tafarkin aiki da aka wallafa kamar "diagnose this site" ko "prepare a migration").
Tsaron lafiya yana da kamanceceniya da tabbatar da asali: OAuth 2.1, alamomin da aka ɗaure zuwa ƙungiyar ku da izinin RBAC tare da aiwatar da tsaron matakin jere, waɗanda aka taƙaita kuma ana iya soke su ga kowane kayan aiki, akwatin rairayi daban da na samarwa. Ayyukan da ke haifar da barna — sharewa, dakatarwa, lissafin kuɗi, babban kashe kuɗi — suna buƙatar tabbataccen tabbaci ko manufar amincewar ɗan adam. Ƙayyadaddun ƙimar kuɗi da iyakar kashe kuɗi sun ɗaure ayyukan da AI ke haifarwa na biya, kuma ana sanya kowane kiran MCP cikin rajistar bincike tare da asali, kayan aiki, jayayya da sakamako.
Muna goyon bayan ƙa'idar maimakon haɗa kowace manhaja ɗaya bayan ɗaya, wanda ke nufin zaɓinku na kayan aikin AI na iya canzawa ba tare da haɗin karɓar baƙuncinku ya canza tare da shi ba.
Eh — injin API ɗin dai ne, wanda aka wallafa kuma aka ƙarfafa. Dashboard, na'urar gudanarwa, CLI, mai ba da sabis na Terraform, uwar garken MCP da webhooks duk masu amfani da wuri ɗaya ne, shi ya sa API ba ya bin bayan panel.
Ee. Ana ba da maɓallan Sandbox daban da maɓallan samarwa kuma suna aiki a yanayin gwaji: babu lissafin kuɗi na gaske kuma babu samar da ainihin sabis. Nuna CI ɗinku zuwa bayanan shaidar sandbox kuma ku aiwatar da cikakken tsarin buƙata da amsa cikin aminci.
Aika Idempotency-Key a kan POST ɗinku. Ana rubuta bayanan sake kunnawa yayin commit maimakon a cikin layi (inline), don haka sake gwadawa ba zai taɓa iya sake kunna nasarar da aka ajiye a cache ba don layin da ba a yi commit ɗinsa ba a zahiri, kuma buƙatar da ta gaza tana sakin makullinta nan take don kar a tsaida gyararren sake gwadawarku. Isar da saƙon Webhook an ƙera shi ya zama aƙalla sau ɗaya (at-least-once) — ku cire kwafi dangane da envelope id a ɓangarenku.
Ba yau ba. Ana ba da makullan API ga kowace kungiya, don haka hadewar da ta shafi kungiyoyin abokan ciniki da dama tana rike da makulli ga kowannensu. Hakanan ana duba izini ga kowace kungiya don manyan masu amfani: rike sites.create a wata kungiya ba ya ba da damar shiga a wata kungiya ta daban kuma marar alaka, kodayake yana aiki ga kungiyoyin da ke karkashin waccan. Hakan da gangan ne — yana takaita makullin da aka yi wa kutse ga kungiyarsa kadai da kuma kananan kungiyoyin da ke karkashinta, ba duka dandalin ba.
Matsayin dev ya ƙunshi karanta bayanan ƙungiya, sarrafa maɓallan API, duba da ƙirƙirar rukunonin yanar gizo, sake kunna su, share maɓoyar bayanansu (cache), da kuma duba tare da ba da amsa ga tikiti. Da gangan aka cire ikon sarrafa lissafin kuɗi daga ciki. Lura cewa izinin turawa (deploy) da push-to-live ba sa cikin sa — idan wani memba na ƙungiyar yana buƙatar su, sanya masa matsayin da ya ƙunshi waɗannan izini maimakon ɗauka cewa Developer shine matsayi na fasaha mafi faɗi.
Ana sake ƙoƙarin isarwa tare da ɗan dakatawa (backoff) kuma ana rikodin kowane ƙoƙari a matsayin WebhookDelivery wanda zaku iya bincika. A ɓangaren upstream, ana rubuta al'amura zuwa akwatin fita na cinikayya (transactional outbox) a cikin ma'amalar rumbun adana bayanai ɗaya da canjin kansa, don haka babu abin da ke ɓacewa yayin da mai karɓa baya nan — mai karɓa da ya faɗi yana jinkirta ne kawai, baya taɓa karya mai samarwa, kuma zaku iya sake tura isarwa daga allon sarrafawa da zarar kun dawo.
Fara gwajin kwanaki 14 kyauta ba tare da katin bashi ba na Footprint-Free Hosting — babu bayanan biyan kuɗi, har shafuka 5. Matakan Footprint-Free na biya suna farawa daga $6/mo don PBN 5. Duk wani tsari yana dauke da garantin dawo da kuɗi na kwanaki 30, ƙaura kyauta kuma babu ɗaurin mai kaya.
API mai bin ƙa'ida da farko, SDKs da aka samar, CLI, mai samar da Terraform, sa hannun webhooks da uwar garken MCP — a kan baƙuncin yanar gizo da muka gina don shafuka sama da 700,000 a duniya. Fara da gwajin kwanaki 14 ba tare da katin banki ba, babu bayanan biyan kuɗi.
Fara kyautaKo da wanne daga cikin waɗannan plugins yana mai da shafin ku na WordPress ya zama uwar garken MCP, ta yadda Claude, Cursor, VS Code da sauran mataimakan AI za su iya yin aiki na gaske a kan sa, an shiga a matsayin ku kuma an iyakance shi ga abin da aka ba ku izinin yi.