Ku socota horumariyeyaasha
Zinn Digital® waa madal ku shaqaysa API-first. Isla mishiinka API ee awooda siiya dashboard-keena ayaa ah kan aad helayso — noocyeysan, qeexitaan-horreeye ah oo 100% la diiwaangeliyay xilliga dhisidda, iyadoo ay la socdaan SDK-yo la sameeyay, CLI, adeeg-bixiye Terraform, webhooks la saxiixay iyo adeege MCP oo dushiisa ah. Wax kasta oo aad u isticmaasho shaqada — ha ahaato terminal, pipeline, fayl xaaladeed ama wakiil AI — madashu way ka jawaabaysaa.
Inta badan martigeliyayaashu waxay API ku daraan koontaroolka gadaal ka dib, taasina way muuqataa — kala bar astaamaha qaybta marna ma soo baxaan. Annagu waxaan u dhisnay habka lidka ku ah. Dashboodhka, qunsulka maamulka, CLI, adeeg-bixiyaha Terraform, seerfarka MCP iyo is-dhexgalkaaga gaarka ah dhammaantood waxay adeegsadaan isla hal mishiin API ah. Haddii aad ku samayn karto qaybta, waxaad ku samayn kartaa koodh ahaan.
Faahfaahinta OpenAPI waa ilaha keliya ee xaqiiqda, mana jiro bar-dhamaad la daabaco ilaa uu ku jiro faahfaahinta mooyee. Xeerkaas keliya ayaa ah waxa ka dhigaya API-ga guud mid si buuxda loo diiwaangeliyo xilliga dhismaha halkii ay hadhow noqon lahayd — ma jiro gees aan la diiwaangelin, sababtoo ah bar-dhamaad aan la diiwaangelin ma jiri karo.
Dukumentiyada tixraaca ee is-dhexgalka leh, afarta SDK ee macmiilka, qayb badan oo ka mid ah CLI iyo qaab-dhismeedka bixiyaha Terraform dhammaantood waxaa laga soo saaraa hal qeexitaan oo keliya. Hal il, wax soo saar badan, mar walba iswaafaqsan — marna uma baahnid inaad raacdo dukumeenti ka fogaaday hirgelinta dhabta ah.
Barta dhammaadka waxay ku hoos jiraan /v1 iyagoo wata siyaasad joojin ah oo la daabacay iyo diiwaanka isbeddellada. Waxaa lagugu wargelin doonaa qoraal ahaan ka hor inta aan waxba isbeddelin, halkii aad ka ogaan lahayd dhismo fashilmay.
Tijaabooyinka heshiiska ee hirgelinta iyo qeexitaanka iyo hubinta OpenAPI waxay shaqeeyaan isbeddel kasta. Isma-dhignaanta u dhexeysa koodhka iyo heshiiska waxay keenaysaa in dhisiddu fashilanto — markaa qeexitaanka aad ka soo saarto macmiilkaaga waa qeexitaanka uu serfarku dhab ahaantii u hoggaansamo.
Laba hab oo loo galo, hal mabda' oo isku mid ah oo ka dambeeya. Midka aad isticmaashaba, isla hubinta oggolaanshaha iyo isla go'doominta heerka xog-ururinta ayaa khuseeya.
Furayaashu waxay u eg yihiin zdk_<mode>_<prefix>_<secret>. Kaliya SHA-256 hash oo sirta ah ayaa la keydiyaa — ma awoodno inaan mar kale ku tuso furaha ka dib marka la bixiyo, sidoo kale cid kasta oo gaadha xog-ururintayada ma awoodo. Furayaashu waxay wataan xaddidaadyo, waa la burin karaa, waxaana loo bixiyaa hay'ad kasta halkii qof kasta laga siin lahaa.
Furayaasha tijaabada (sandbox) way ka go'an yihiin furayaasha wax-soo-saarka waxayna ku shaqeeyaan qaabka tijaabada: ma jiraan qaansheegad dhab ah, mana jirto bixin kheyraad oo dhab ah. Tijaabooyinkaaga isku-dhafka ahi waxay si xad-dhaaf ah u tijaabin karaan API-ga iyadoon lacag la bixin ama server-yo la dhisin.
Kulamada isticmaalaha waxaa lagu xaqiijiyaa JWT-yo ay bixisay Keycloak, kuwaas oo lagu hubiyo furaha guud ee realm-ka, waxayna u xallismaan isla walaxda Principal ee furaha API-gu u xallismo. Baraha dhamaadka waxay ku xiran yihiin furayaasha oggolaanshaha faahfaahsan sida sites.create ama apikeys.manage, kuwaas oo loogu hubiyo urur kasta gooni ahaan — oggolaanshaha hal urur ma bixiyo wax fursad ah oo lagu galo urur gaar ah oo aan xiriir la lahayn, in kastoo uu quseeyo ururada hoos yimaada.
Codsi kasta oo kireyste wuxuu ku dhex shaqeeyaa macaamil leh baaxadda hay'adda Postgres oo laga dejiyay maamulaha (principal), sidaas darteed go'doominta waxaa fuliya kaydka xogta, ee ma aha shaandhada ORM oo laga yaabo in qof iloobo. Shaandhada queryset weli waxay u taallaa sidii difaac qoto dheer.
API way fududahay in loo ekeysiiyo mid wanaagsan gudaha README, waxaana adag in la helo inuu si sax ah ugu shaqeeyo taraafikada dhabta ah. Kuwani waa qaybihii aan dhididka badan u soo daadinnay, maxaa yeelay waa qaybaha fashiliya is-dhexgalka saddexda habeenkimo.
Faahfaahin mudan in la xuso, sababtoo ah waxay qaabaysaa sida hawsha tirada badan u shaqeyso: qaladka 409 ee magaca domain-ka labanlaabmay wuxuu ka jawaabayaa "magaca martigeliyaha ma lagu martigeliyay halkan?" kireyste kasta, taasoo ah orakol tirakoob iyo khatar dhab ah oo ka dhanka ah aqoonsi-qarsiga Footprint-Free. Xaddididda abuurista goobta waxay ahaan lahayd xal fudud oo caajis ah waxayna si buuxda u carqaladayn lahayd adeegga diyaarinta tirada badan. Taa beddelkeeda kaliya isku-dayada magacyada domain-ka labanlaabmay ee la diiday ayaa miisaaniyad loo qoondeeyaa, maamule kasta. Abuuritaanka guuleystay waligood laguma xisaabiyo miisaaniyaddaas — markaa waxaad diyaarin kartaa tiro badan maalintii oo dhan, baaritaannada aan habboonaynna waxay joogsanayaan ku dhawaad isla markiiba.
Saddex isticmaale oo isku sifo ah, saddex hab oo kala duwan oo shaqo ah.
Loo sameeyay TypeScript, Python, PHP iyo Go, iyadoo la raacayo qeexitaanka si meel cusub oo dhammaad ah ugu timaado luqaddaada adigoon sugin wrapper gacanta lagu qoray.
Samee qaab-dhismeedka goob WordPress ah, ku socodsii gudaha adigoo aan wax kale ku rakibin marka laga reebo Node, oo daabac. Zinnector® waxay mashruucaaga ka hor hubisaa booska aad ku dhowdahay inaad wax geliso — nooca PHP, saxanka, tirada faylasha — waxayna ka digtaa ka hor inta aadan riixin intii ay ka dib ahaan lahayd. Waxa kale oo ay gashaa nidaamka, liis garaysaa goobaha, daabacdaa, maamushaa magacyada domain-ka iyo DNS, akhrisaa adeegyada boostada, qaadataa koobiyada kaydka ah, socodsiisaa WP-CLI la oggol yahay, la socotaa qoraallada log-ga waxayna fulisaa hawlo wadareed. Waa bilaash, shati MIT leh, waxaana lagu dhisay isla API-gan guud.
U maamul baraha, domain-yada, diiwaannada DNS-ka, sanduuqyada boostada iyo qorshayaasha sida kaabayaal dhaqaale oo xeer ah (infrastructure as code). terraform apply waxay diyaarisaa martigelinta, deegaannadaaduna waxay noqdaan kuwo dib loo soo saari karo lana dib-u-eegi karo halkii ay ka ahaan lahaayeen gujiyo isxiga oo aan cidina qorin.
Dukumentiyada la soo saaray oo aad ka akhrisan karto oo aad ka wici karto biraawsarka, iyaga oo si sax ah u qeexaya barta dhammaadka ee uu adeeguhu hirgeliyo — sababtoo ah labaduba waxay ka yimaadeen isla qeexitaan.
Madasha gadaasheeda waxaa ku yaal laf-dhabar dhacdo oo waara: isbeddel kasta oo xaaladeed wuxuu dhacdo si atoomik ah ugu qoraa outbox wax kala iibsi oo ku jira Postgres oo ay weheliso isbeddelka xog-ururinta, waxaana relay u daabacaa NATS JetStream. Dhacdooyinka waa kuwo noocaysan oo leh noocyo kala duwan — site.deployed, order.paid, invoice.overdue, backup.completed, abuse.flagged, trial.ending iyo kuwa kaleba.
U diiwaangeli barta dhammaadka sidii WebhookSubscription oo dooro noocyada dhacdada ay hesho. Hal qulqul ayaa quudiya ogeysiisyada, falanqaynta, otomaatigyada iyo isku-darkaaga si isku mid ah — waxaad isticmaalaysaa isla dhacdooyinka aan annaguba isticmaalno.
Bixin kasta waxa lagu saxeexay HMAC si aad u xaqiijin karto inay annaga naga timid ka hor inta aanad ka hawlgelin.
Gaarsiinta fashilantay waxaa dib loogu celiyaa dib-u-dhac tartiib-tartiib ah, isku day kastaana waxaa loo diiwaangeliyaa sidii WebhookDelivery. Waxaad ka baari kartaa dibna uga ciyaari kartaa gaarsiinta gudaha dashboard-ka halkii aad taageerada iimayl ugu diri lahayd adigoo weydiinaya waxa aan dirnay.
Dhuumaha waxaa si ula kac ah looga dhigay ugu yaraan hal mar halkii laga yeeli lahaa inay iska dhigaan mid sax ah oo hal mar ah. Gudbiye xumaada inta lagu guda jiro daabacaadda, kirada sheegashadiisu way dhacaysaa oo dhacdooyinkiisa dib ayaa loo daabacayaa. Ku samee baabi'inta nuqullada envelope id-ga markaas macamiilkaagu wuxuu u saxan yahay hab-dhismeed ahaan.
API waa kala bar kaliya sheekada horumariyaha. Qeybta kale waa soo saarista.
API-gu waa hal albaab. Kuwani waa afarta kale, mid walbana waxa lagu daray qorshaha halkii loo iibin lahaa heerka horumariyaha.
VS Code ee ku dhex jira biraawsarka, oo laga furay bogga goobta ee ku yaal dashboard-ka, isagoo tafatiraya faylasha dhabta ah ee goobtaas oo leh git ku dhex dhisan iyo tifaftiraha oo dhan oo ku dhex jira isla xabsiga CageFS ee gelitaankaaga SFTP. Waxay tafatirtaa goobta TOOSKA AH — ma jirto koobi ku-meel-gaar ah oo u dhexeysa, sidaas darteed faylka aad kaydiso wuxuu noqonayaa mid guud isla marka la qoro, in kasta oo faylka ma guurtada ahi uu sii wadi karo inuu ka adeego kaydka CDN ilaa afar saacadood.
Bilaash ah, shatiga MIT ku shaqeeya isla markaana lagu dhisay isla API-gan guud. Samee qaab-dhismeedka bogga WordPress, ku shaqaysii kombiyuutarkaaga, ka hor-hubi booska aad ku talajirto inaad geyso — nooca PHP, saxanka kaydinta, tirada faylasha — kadibna hirgeli. Waxay u baahan tahay Node 24 ama ka cusub.
Hal buug-tixraac oo qalab ah, si macmiilka AI ee aad hadda isticmaasho uu uga shaqeyn karo boggagaaga isaga oo adeegsanaya isla API-ga iyo isla rukhsadaha uu isticmaalo muraayadda kantaroolku. Isla serfer-ka uu macmiilkaagu ku xirmo ayaa ah midka ku xiran tifaftiraha shabakadda. Akhris-keliya ilaa aad si kale u sheegto.
Shaqada macmiilku uma baahna eraygaaga sirta ah. Qof kaga casuum cinwaanka iimaylka waxayna si sax ah u helayaan hal goob: waxay ku soo galaan magacooda, iyagoo wata doorka daawade, tifaftire ama maamule, goob kasta oo kalena waxay ku jawaabaysaa 404 ka hor inta uusan shaqaynin maamule kasta — siyaasad ammaan heer-safka Postgres ah iyo xayndaab heer-codsi ah, ma aha hal hubin oo keliya. Mulkiilaha koontadu wuu oggolaanayaa wuuna kala noqonayaa hal gujin oo keliya, taasoo dhaqangaleysa codsigooda xiga.
Waxaan madasha u bixinaa sidii adeegaha MCP ee martigeliyay: qabsade borotokool oo dhuuban oo dul saaran mashiinka API kaas oo dib u adeegsada buug-yaraha ficilka ee isku midka ah, RBAC iyo raadraaca hubinta. Ku xidh Claude Code, Cursor, ChatGPT, Claude Desktop ama macmiil kasta oo awood u leh MCP hal mar, wax kasta oo aan ku darno API-na waxay noqon doonaan kuwo si toos ah ugu diyaarsan.
Wakiilku wuxuu helayaa saddex waxyaabood: Tools (isla dhibcaha dhamaadka API, ma jirto caqli barbar socda oo leexanaya), Resources (caafimaadka bogga ee kaliya la akhrin karo, qaabeynta, diiwaannada dhowaan, halbeegyada, waqtiga shaqada iyo qodobbada KB, si uu ugu baaro xog dhab ah ka hor inta uusan ficil qaadin) iyo Prompts (tusaalooyinka socodka shaqada ee la daabacay sida "diagnose this site" ama "prepare a migration").
Badbaadadu waxay la mid tahay xaqiijinta aqoonsiga: OAuth 2.1, tokens ku xidhan ururkaaga iyo oggolaanshaha RBAC oo leh amniga heerka-safka oo la dhaqangeliyay, xaddidan oo laga noqon karo qalab kasta, sandbox ka soocan production. Ficillada wax baabi'iya — tir, hakin, biilasha, kharashka badan — waxay u baahan yihiin xaqiijin cad ama xeer oggolaansho qof ahaaneed. Xaddidaadaha xawaaraha iyo xaddidaadaha kharashku waxay xaddidaan ficillada lacag-bixinta ah ee AI-kiciso, waxaana wicitaan kasta oo MCP ah lagu xafidaa diiwaanka hubinta oo ay la socdaan aqoonsiga, qalabka, doodaha iyo natiijada.
Waxaan taageernaa hab-maamuuska halkii aan app kasta si gooni ah isugu dari lahayn, taasoo la micno ah in doorashadaada aaladaha AI ay isbeddeli karto iyada oo aan is-dhexgalka martigelintaadu la beddelin.
Haa — waa isla API-ga mishiinka, oo la daabacay lana xoojiyay. Dashboodhka, konsolka maamulka, CLI, bixiyaha Terraform, seerfarka MCP iyo webhooks dhammaantood waxay adeegsadaan hal oog, waana sababta API-gu uusan uga dambeynin guddiga.
Haa. Furayaasha sandbox-ka waxaa loo soo saaraa si ka gooni ah furayaasha wax-soo-saarka waxayna ku shaqeeyaan qaab tijaabo ah: ma jirto biil bixin dhab ah mana jirto adeeg bixin dhab ah. Ku toosi CI-gaaga xogta aqoonsiga ee sandbox-ka oo si ammaan ah u tijaabi wareegga buuxa ee codsiga iyo jawaabta.
Ku dir Idempotency-Key dalabkaaga POST. Diiwaanka dib-u-ciyaaridda waxaa lagu qoraa commit halkii uu ka ahaan lahaa inline, sidaas darteed isku-dayga dib loogu celiyo waligiis ma dib-u-ciyaari karo guul la keydiyay (cached) oo loogu talagalay saf aan dhab ahaan loo commit-gareyn, codsigii fashilmana wuxuu isla markiiba fasaxayaa qufulkiisa si aan dib-u-daygaaga la saxay dib loogu dhigin. Gaarsiinta Webhook waa ugu yaraan hal mar (at-least-once) marka loo eego naqshadeynta — ka samee dedupe dhinacaaga envelope id dushiisa.
Maanta maaha. Furayaasha API waxaa lagu bixiyaa hay'ad kasta, markaa isdhexgalka ku fidsan dhawr hay'adood oo macaamiil ah wuxuu hayaa fure mid kasta. Ogolaanshaha sidoo kale waxaa loo hubiyaa hay'ad kasta maamulayaasha isticmaalaha: haysashada sites.create ee hal hay'ad ma bixinayso gelitaan hay'ad gooni ah oo aan xidhiidh la lahayn, in kasta oo ay khusayso hay'adaha ku dhex yaal middaas hoosteeda. Taasi waa ula kac — waxay ku koobaysaa fure la carqaladeeyay hay'addiisa iyo hay'adaha hoos yimaada, ee maaha madal dhan.
Doorka dev wuxuu koobayaa akhrinta ururka, maamulka furaha API, daawashada iyo abuurista boggaga, dib-u-bilaabistooda, nadiifinta kaydkooda (cache), iyo daawashada iyo ka jawaabista tigidhada. Waxa uu si ula kac ah uga reebayaa maamulka biilasha. Ogsoonow in rukhsadaha daadgureynta (deploy) iyo u gudbinta tooska ah (push-to-live) aysan qayb ka ahayn — haddii xubin kooxeed uu u baahan yahay kuwaas, u qoondee door wata halkii aad u qaadan lahayd in Developer uu yahay doorka farsamo ee ugu ballaaran.
Bixinta dib ayay isku daydaa iyadoo la isticmaalayo dib-u-dhac tartiib-tartiib ah waxaana isku day kasta loo duubaa sida WebhookDelivery oo aad baari karto. Qaybta sare, dhacdooyinka waxaa lagu qoraa sanduuqa baxaya ee macaamil ganacsi (transactional outbox) isla macaamilka kaydka xogta ee isbeddelka laftiisa, sidaa darteed waxba ma lumaan inta uu macaamiilku maqan yahay — macaamiilka xumaada dib buu u dhacaa, marnaba ma jabiyo soo-saaraha, waxaadna dib uga ciyaari kartaa bixinta dashboard-ka marka aad dib u soo laabato.
Ku billaw tijaabada 14-maalmood ee Footprint-Free Hosting adigoon kaadhadh isticmaalin — ma jiraan xog lacag bixineed, ilaa 5 goobood. Heerarka lacagta lagu bixiyo ee Footprint-Free waxay ka start garoobaan $6/bishiiba ee PBN 5. Qorshe kasta wuxuu leeyahay damaanad-qaad 30-maalmood oo lacag-soo-celin ah, ku-wareejin lacag-la'aan ah iyo inaan la kugu xidhin hal iibiye.
API ku saleysan faahfaahinta, SDK-yo la sameeyay, CLI, bixiyaha Terraform, webhooks la saxiixay iyo adeegaha MCP — martigelinta aan u dhisnay in ka badan 700,000 oo bogag adduunka oo dhan ah. Ku bilow tijaabo 14-maalmood ah oo bilaash ah oo aan kaar lahayn, faahfaahinta lacag bixinta la'aanteed.
Ku bilow bilaashMid ka mid ah sababaha plugins-kan ayaa goobtaada WordPress ka dhigaya server MCP ah, si Claude, Cursor, VS Code iyo kaaliyeyaasha kale ee AI ay uga qabtaan shaqo dhab ah dusha sare, iyagoo ku soo galay magacaaga isla markaana ku kooban waxa laguu oggol yahay inaad samayso.