Don masu haɓakawa
Zinn Digital® wani dandali ne na API-first. Injin API ɗin da ke tafiyar da dashboard ɗinmu shi ne wanda kake samu — mai versioning, wanda aka tsara da farko kuma an rubuta bayanai akansa 100% yayin ginawa, tare da samar da SDKs, CLI, mai ba da Terraform, webhooks da aka sanya hannu da kuma sabar MCP a sama da su. Duk abin da kake amfani da shi wajen aiki — tasha (terminal), bututun aiki (pipeline), fayil ɗin jiha (state file) ko wakilin AI — dandalin yana amsa masa.
Yawancin kamfanonin daukar shafuka suna kafa API ne a kan rukunin kula da abubuwa bayan an gama komai, kuma hakan yana bayyana — rabin abubuwan da ke cikin rukunin ba sa samun damar fita waje. Mu kuwa mun gina shi ta hanyar da ta dace. Allon sarrafawa, sashin gudanarwa na masu mulki, na'urar CLI, mai bayar da Terraform, uwar garken MCP da naku hadewar duk suna amfani da injin API ɗaya ne. Idan za ku iya yi a cikin rukunin, za ku iya yi a cikin lambar kwamfuta.
Takaitaccen bayanin OpenAPI shine tushen gaskiya, kuma babu wani madogarar da za a fitar sai dai idan tana ciki. Wannan doka guda ɗaya ce ke sa jama'a su sami cikakken bayanin API yayin ginawa maimakon daga baya — babu wani kusurwa da ba a rubuta bayani akanta ba, domin ba a iya samun madogarar da babu bayani akanta.
Takardun bayani masu hulɗa da juna, abokan hulɗa huɗu na SDKs, mafi yawan CLI da tsarin ginin mai ba da sabis na Terraform duk an samar da su ne daga wannan takamaiman bayanin. Tushe guda ɗaya, kayayyaki da yawa, kuma koyaushe suna cikin jituwa - ba za a taba samun matsalar takardar da ta kauce daga abin da aka aiwatar ba.
Ana samun ƙarshen hanyoyin sadarwa a ƙarƙashin /v1 tare da ƙa'idar daina amfani da su da aka buga da kuma bayanin sauye-sauye. Ana sanar da ku kafin wani abu ya canza, a rubuce, maimakon gano hakan daga ginin da ya gaza.
Gwaje-jin kwangila tsakanin aiwatarwa da takaitaccen bayani da kuma binciken OpenAPI suna gudana a kowane sauyi. Bambanci tsakanin lambar da kwangilar yana sa ginin ya gaza — don haka takaitaccen bayanin da kake samar da abokin cinikin ka daga gare shi shine takaitaccen bayanin da uwar garken ke girmamawa sosai.
Hanyoyi biyu na shiga, amma tsari guda daya ne ke bayan su. Duk wacce kake amfani da ita, ana amfani da wadannan matakan duba izini da kuma kebewa ta matakin rumbun bayanai.
Maɓallan suna kama da zdk_<mode>_<prefix>_<secret>. Ana adana hash ɗin SHA-256 na sirrin ne kawai — ba za mu iya nuna muku maɓalli ba bayan bayarwa, kuma babu wanda zai iya shiga bayananmu da zai iya haka. Maɓallan suna da iyakokin aiki, ana iya soke them, kuma ana ba da su ne ga kowace kungiya maimakon ga kowane mutum.
Makullin yanayin gwaji (sandbox) sun bambanta da makullin samarwa kuma suna aiki a yanayin gwaji: babu takardun kudi na gaske, babu tanadin sabis na gaske. Gwaje-gwajen hadewarku na iya amfani da API ba tare da kashe kudi ko gina sabar ba.
Zaman mai amfani yana tabbatar da gaskiya tare da JWTs da Keycloak ya bayar, wanda aka tantance bisa ga maɓallin jama'a na realm, kuma ya koma zuwa abu ɗaya na Principal kamar yadda maɓallin API ke yi. Ƙarshen hoto suna buƙatar takamaiman maɓallan izini kamar sites.create ko apikeys.manage, waɗanda ake bincika ga kowace ƙungiya — izini a ƙungiya ɗaya baya ba da damar shiga a wata ƙungiya daban da ba ta da alaƙa, kodayake yana aiki ga ƙungiyoyin da ke ƙarƙashinta.
Kowane buƙatun mai haya yana gudana ne a cikin mu'amala tare da iyakacin ƙungiyar Postgres da aka saita daga babban jami'i, don haka raba keɓewa ya zama dole ta hanyar rumbun adana bayanai, ba ta hanyar tace ORM da wani zai iya mantawa ba. Tacewar queryset tana nan har yanzu a matsayin kariya mai zurfi.
Yana da sauƙi a sa wani API ya yi kyau a cikin README amma yana da wahala a sa shi ya yi aiki yadda ya kamata a ƙarƙashin ainihin cunkoson ababen hawa. Waɗannan sune ɓangarorin da muka yi matuƙar aiki a kiansu, domin su ne ɓangarorin da ke rushe haɗin gwiwa da misalin ƙarfe uku na safe.
Wani bayani mai muhimmanci da ya kamata a lura da shi, domin yana shafar yadda aikin jeri ke gudana: lambar 409 kan yanki mai kwafi tana amsa tambayar "ana karɓar bakuncin wannan sunan mai masauki anan?" ga kowane mai haya, wanda hakan oracle ne na lissafi kuma babbar barazana ce ta bayyana ainihi ga Footprint-Free. Taƙaita ƙirƙirar rukunin yanar gizo zai zama mafita mai sauƙi kuma zai lalata samfurin samar da kayayyaki na jeri gaba ɗaya. Madadin haka, kawai an ware kasafin kuɗi ne ga yunƙurin yin kwafin yanki da aka ƙi, ga kowane babban jami'i. Ba a taɓa cire kuɗi daga samfuran da suka yi nasara ba — don haka zai yiwu a samar da kayayyaki a jeri duk rana, kuma bincike yana karewa kusan nan da nan.
Masu amfani guda uku masu tsari iri ɗaya, don hanyoyin aiki daban-daban guda uku.
An samar da shi don TypeScript, Python, PHP da Go, yana bin ƙayyadaddun bayanai ta yadda sabon wurin shiga (endpoint) zai isa cikin harshen ku ba tare da jiran mai rubuta hannu ba.
Yi ginin rukunin yanar gizo na WordPress, ka gudanar da shi a cikin kwamfutarka ba tare da an sanya komai ba sai dai Node, sannan ka tura shi zuwa intanet. Zinnector® yana nazarin aikin ka kafin ka tura shi zuwa wurin da kake shirin turawa — sigar PHP, sararin diski, adadin fayiloli — kuma yana ba da gargadi kafin ka tura maimakon bayan ka tura. Haka zalika yana shiga, yana lissafa rukunin yanar gizo, yana turawa, yana sarrafa yankuna da DNS, yana karanta ayyukan imel, yana ɗaukar ajiyar bayanai, yana gudanar da WP-CLI da aka ba izini, yana duba rajistar ayyuka kuma yana gudanar da ayyuka masu yawa a lokaci gaya. Kyauta ne, mai lasisin MIT, kuma an gina shi a kan wannan jama'a API.
Sarrafa shafuka, yankuna (domains), bayanan DNS, akwatunan saƙo da tsare-tsare azaman ababen more rayuwa kamar lambobi (infrastructure as code). `terraform apply` yana tanada wuraren shiga yanar gizo, kuma yanayin ku zama masu sake fitowa da kuma dubawa maimakon jerin danna abubuwan da babu wanda ya rubuta.
Takardun da aka samar da za ku iya karantawa da kira daga burauza, suna bayyana ainihin ƙarshen wuraren da uwar garken ke aiwatarwa — domin dukansu sun fito daga ƙayyadaddun bayanai guda.
Bayan dandalin akwai kashin bayan taron mai ɗorewa: kowane sauyin yanayi yana rubuta taron zuwa akwatin waje na ma'amala a Postgres, tare da canjin bayanan bayanai, kuma watsawa yana buga shi zuwa NATS JetStream. Abubuwan da suka faru an rubuta su kuma an tsara su - site.deployed, order.paid, invoice.overdue, backup.completed, abuse.flagged, trial.ending da sauran su.
Yi rajistar wani wuri a matsayin WebhookSubscription sannan ka zaɓi nau'ikan abubuwan da zai karɓa. Wata guda ce ke samar da sanarwa, nazari, sarrafa kansa da haɗin gwiwarku tare – kuna amfani da irin waɗannan abubuwan da muke amfani da su.
Ana sanya wa kowane isar da sako sa hannu na HMAC ta yadda za ku iya tabbatar da cewa daga wurinmu ya fito kafin ku dauki mataki akai.
An sake gwada jigilar da ta gaza tare da jinkiri kuma an rubuta kowane kokari a matsayin WebhookDelivery. Kuna iya bincika da sake kunna jigilar daga dashboard maimakon tura imel zuwa goyon baya kuna tambayar abin da muka aika.
An tsara bututun sarrafa bayanan yadda ya kamata ya zama akalla sau daya maimakon yin kamar sau daya ne kawai. Wani na'urar watsa labarai da ta mutu a tsakiyar bugawa tana da takardar shaidar da ta ƙare kuma an sake buga abubuwan da ta fitar. Yi cire kwafi akan ID din rufewa kuma mai amfani da ku yana da daidaito ta hanyar ginawa.
API rabi ce kawai ta labarin mai haɓakawa. Ragowar rabin ita ce fitarwa.
API ɗaya ce kofa. Waɗannan su ne sauran huɗu, kuma kowace ɗaya daga cikinsu tana zuwa ne tare da tsarin maimakon a sayar da ita a matsayin matakin masu haɓakawa.
VS Code a cikin burauzara, wanda aka buɗe daga shafin yanar gizon a cikin allon sarrafawa, yana gyarainiƙinan fayilolin gidan yanar gizon tare da git da aka gina a ciki da dukan editan a cikin CageFS jail ɗaya kamar yadda SFTP ke da dama. Yana gyara shafin da ke ZAYANA — babu kwafin shiri a tsakani, saboda haka fayil ɗin da kuka adana yana bayyane a daidai lokacin da aka rubuta shi.
Kyauta, mai lasisi ta MIT kuma an gina ta a kan wannan ingantacciyar jama'a API. Gina rukunin yanar gizon WordPress, gudanar da shi akan na'urarka ta kanka, gwada shi kafin turawa zuwa ga wuri da kake shirin turawa — sigar PHP, faifai, adadin fayil — sannan ka tura. Yana buƙatar Node 24 ko sabon abu.
Katalog ɗaya na kayan aiki, ta yadda abokin ciniki na AI da kake amfani da shi tun riga zai iya aiki a kan shafukanka ta hanyar API iri ɗaya da izini iri ɗaya da dashboard ɗin ke amfani da su. Sabar iri ɗaya da abokin cinikin ka ke haɗawa da ita ita ce aka haɗa cikin editan yanar gizo. Karatu kawai sai dai idan ka faɗi akasin haka.
Aikin abokin ciniki ba ya buƙatar kalmar sirrinka. Gayyaci wani ta adireshin imel kuma za su sami takamaiman shafi ɗaya: suna shiga a matsayin su da k ඔවුන්u, tare da matsayin mai kallo, edita ko manaja, kuma kowane shafi daban yana ba da 404 kafin kowane mai sarrafa ya yi aiki — manufofin tsaro na matakin jeri na Postgres da shingen matakin buƙata, ba bincike ɗaya ba. Mai mallakar asusun yana ba da shi kuma yana soke shi da danna ɗaya, wanda zai fara aiki a buƙatar su ta gaba.
Mun fitar da dandamalin a matsayin uwar garken MCP da aka karbi bakonci: madaidaicin adaftar yarjejeniya ta kan injin API wacce ke sake amfani da kasidar aiki iri ɗaya, RBAC da kuma hanyar bincike. Haɗa Claude Code, Cursor, ChatGPT, Claude Desktop ko kowane abokin ciniki mai ƙarfin MCP sau ɗaya, kuma kowace fasaha da muka ƙara zuwa API zai kasance a shirye gare shi ta atomatik.
Wakili yana samun abubuwa guda uku: Kayan aiki (iri ɗaya da API endpoints, babu wani ma'ana mai nisa da zata kauce), Abubuwan da aka tanada (lafiyar shafin da ba a iya gyarawa, tsari, bayanan da suka gabata, ma'apani, lokacin aiki da labaran KB, don haka yake bincike tare da ingantaccen bayani kafin ya yi aiki) da kuma Ƙarfafawa (samfuran aikin da aka buga kamar su "binciki wannan shafin" ko "shirya ƙaura").
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.
Mungo maraba da ka'idar maimakon haɗa kowace app ɗaya bayan ɗaya, wanda hakan ke nufin zaɓinku na kayan aikin AI zai iya canzawa ba tare da haɗin gwiwar ku na hosting ya canza tare da shi ba.
Eh — yana amfani da injin API ɗaya ne, wanda aka wallafa kuma aka ƙarfafa shi. Allon kulawa, na'urar gudanarwa, CLI, mai ba da Terraform, sabar MCP da webhooks duk masu amfani da wuri ɗaya ne, shi ya sa API ɗin ba ya zama baya ga allon sarrafawa.
Eh. Ana ba da maɓallan sandbox daban da maɓallan samarwa kuma suna aiki a yanayin gwaji: babu takardun kuɗi na gaske kuma babu tanadin gaske. Yi nuni da CI ɗin ku zuwa takaddun shaida na sandbox kuma ku gwada cikakken tsarin buƙata da amsa lafiya.
Aika da Idempotency-Key a kan POST dinka. Ana rubuta bayanan sake kunnawa ne lokacin da aka aikata (commit) maimakon a lokacin tafiya (inline), ta yadda sake gwadawa ba zai taba sake kunna nasarar da aka adana a cache ba na wani sahu da bai zahiri ba wajen aikatawa, kuma buƙatar da ta gaza tana sakin makullinta nan take ta yadda ba za a tsaida sake gwada gyaranka ba. Isar da Webhook yana faruwa ne aƙalla sau ɗaya ta yadda aka tsara shi — cire kwafi (dedupe) a kan lambar ambulaf (envelope id) a gefenku.
Ba a yau ba. Ana ba da maɓallan API ne ga kowace kungiya, don haka haɗin gwiwa da ya shafi kungiyoyin abokin ciniki da yawa yana da maɓalli ga kowace ɗaya. Haka kuma ana bincika izini ga kowace kungiya don manyan masu amfani: riƙe sites.create a kungiya ɗaya baya ba da damar shiga a wata daban, maras alaƙa, kodayake yana aiki ga kungiyoyin da ke ƙarƙashin waccan. Wannan abu ne da aka tsara da gangan — yana iyakance maɓalli da aka lalata ga kungiyarsa kawai da kuma ƙananan kungiyoyin da ke ƙarƙashinta, ba duka dandalin ba.
Matsayin mai haɓakawa ya ƙunshi karanta ƙungiyar, sarrafa maɓallin API, kallo da ƙirƙirar shafuka, sake kunna su, share ma'ajiyar su, da kallo da amsa tikiti. An cire ikon sarrafa kudi da gangan. Lura cewa izinin tura kaya da tura-kai-tsaye ba su cikin sa - idan memba na ƙungiya yana buƙatar waɗannan, sanya matsayin da ke ɗauke da su maimakon ɗauka cewa Mai haɓakawa shine mafi fadi da matsayin fasaha.
Ana sake gwada isarwa tare da jinkiri kuma ana rubuta kowane yunkuri a matsayin WebhookDelivery wanda za ku iya dubawa. A gefe guda kuma, ana rubuta abubuwan da suka faru zuwa cikin wani akwatin ajiyar ma'amala a cikin ma'amalar bayanan da ta dace da canjin kanta, don haka babu abin da zai ɓace yayin da mai amfani ba ya nan — mai amfani da ya tsaya yana samun jinkiri, ba ya taba lalata mai samar da kaya, kuma za ku iya sake kunna isarwa daga allon kula da bayanai da zaran 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 na farko na musamman, SDKs da aka samar, CLI, mai ba da Terraform, signed webhooks da sabar ta MCP - akan abin da muka gina don rukun yanar gizo fiye da 650,000 a duk duniya. Fara gwaji na kwanaki 14 ba tare da katin kiredit ba, babu bayanan biya.
Fara kyauta