Horumariyeyaasha
Zinn Digital® waa madal API-horeysa. Engine-ka API ee awooda siiya dashboard-keena waa midka aad heleyso — oo leh noocyo, jaangooyo-hore iyo 100% dukumientiaysan xilliga dhismaha, oo ay la socdaan SDKs la soo saaray, CLI, bixiye Terraform, webhooks saxiixan iyo server MCP ah oo dusha ka saaran. Wax kasta oo aad u isticmaasho in aad ku shaqeyso — terminal, pipeline, faylka state-ka ama wakiil AI ah — madalku waa ay u jawaabaysaa.
Intیکس host-yadu waxay API ku daraan control panel-ka kadib markay dhammeeyaan, taas ayaana muuqata — kala bar astaamaha panel-ka weligood ma soo baxaan. Annagu si ka duwan ayaanu u dhisnay. Dashboard-ka, admin console-ka, CLI-ga, Terraform provider-ka, MCP server-ka iyo is-dhexgalkaaga adigu dhammaantood waxay isticmaalaan hal engine API ah. Haddii aad ku samayn karto panel-ka, waxaad ku samayn kartaa koodka.
Sharaxaadda OpenAPI waa isha runta, mana jiro meel loogu talagalay bixinta adeegga (endpoint) oo la geeyo ilaa ay ka mid tahay sharaxaaddaas. Xeerkaas keliya ayaa ka dhigaya API-ga guud mid si buuxda loo diiwaangeliyey xilliga dhismaha halkii uu noqon lahaa mid mar dhow dhaca — ma jiro gees aan la diiwaangelin, sababtoo ah adeeg aan la diiwaangelin ma jiro.
Dokumentiyada tixraaca ee la falgala, afarta SDK ee macaamiisha, qayb badan oo ka mid ah CLI-ga iyo qaab-dhismeedka bixiyaha Terraform ayaa dhammaan laga soo saaray halbeeggaas. Hal xigasho, oo leh agab badan, oo had iyo jeer la jaanqaadaysa — weligaa ma eryan doontid dukumenti ka leexday hirgelinta.
Meelaha ugu dambeeya ee adeeggu waxay hoos yimaadaan /v1 iyadoo la raaciyo siyaasad la daabacay oo ku saabsan gabowga adeegga iyo buug-gacmeedka isbeddelka. Waxaa lagugu wargelinayaa kahor intaan wax laga beddelin, adoo qoran, halkii aad ka ogaan lahayd dhisme fashilmay.
Implement-versus-spec contract tests iyo OpenAPI linting waxay shaqeeyaan isbeddel kasta. Khilaafka u dhexeeya koodka iyo qandaraas-galka wuxuu fashiliyaa dhismaha — sidaas darteed qandaraas-galka aad ka soo saarto macmiilkaaga waa qandaraas-galka uu server-ku dhab ahaantii sharfayo.
Laba siyaadood oo lagu soo galo, hal mabda' oo mideysan ayaa ka dambeeya. Si kastoo aad u isticmaasho, isla hubinta ogolaanshaha iyo isla go'doominta heerka database-ka ah ayaa lagu dabaqayaa.
Furayaasha waxay u eeg yihiin zdk_<mode>_<prefix>_<secret>. Kaliya SHA-256 hash ee sirta ah ayaa la keydiyaa — ma soo bandhigi karno furaha mar kale marka la soo saaro, mana awoodo cid kasta oo gasha xog-kaydkeenna. Furayaashu waxay wataan baaxad, waa la tirtiri karaa, waxaana loo soo saaraa urur ahaan intii ay ahaan lahaayeen qof kasta.
Furayaasha sanduuqa ciiddu waa kuwo ka go'an furayaasha wax-soo-saarka waxayna ku shaqeeyaan habka sanduuqa ciidda: ma jiraan lacag-bixin dhab ah, ma jiro diyaarin dhab ah. Tijaabooyinkaaga is-dhexgalka ayaa ku garaaci kara API-ga iyada oo aan la kharash-gareyn lacag ama aan la dhisin adeegayaal.
Fadhiyada isticmaalaha waxa lagu xaqiijiyaa JWT-yada uu soo saaro Keycloak, kuwaas oo lagu kormeeray furaha guud ee realm, iyagoo u beddelma isla shayga Principal ee uu furaha API-gu u beddelmo. Endpoints-ku waxay ku xiran yihiin furaheyaal rukhsaddeed oo tafaasiil ah sida sites.create ama apikeys.manage, kuwaas oo looga baaro hay'ad kasta si gaar ah — rukhsadda hay'ad ku jirtaa ma siiso marin hay'ad kale oo kala madaxbannaan, inkastoo ay noqoneyso mid loo adeegsado hay'adaha hoos timaada.
Codsasho kasta oo kireyste ah waxay ku dhex socotaa macaamil (transaction) iyadoo heerka ururka Postgres laga soo dejiyay qofka mas'uulka ah, markaas go'doominta waxaa fulinaya keydka xogta (database), ee ma aha shaandhada ORM oo qof ilaawo. Shaandhada queryset wali way jirtaa si ay u noqoto difaac dheeri ah.
API-ga waxaa sahlan inuu ku fiicnaado README laakiin waa adag yahay inuu si sax ah u shaqeeyo marka ay jiraan taraafiko dhab ah. Kuwani waa qaybaha aan u shaqeynay si adag, sababtoo ah waa qaybaha jebiya is-dhexgalka saqda dhexe ee habeenkii.
Hal tafaasiil ah oo mudan in la xuso, sababtoo ah waxay qaabeysaa sida ay shaqadu u noqoneyso marka la sameeyo tiro badan: jawaabta 409 ee domain-ka nuqul ka ah ah waxay ka jawaabaysaa "ma hostname-kan baa halkan lagu martigeliyay?" tenant kasta, taas oo ah qalab tirin ah iyo khatar dhab ah oo ah in la aqoonsado oo ka dhan ah Footprint-Free. Xaddididda abuurista mareegaha waxay ahaan lahayd xalka caajiska ah waxayna jebin lahayd gebi ahaanba badeecada bixinta tirada badan. Hase yeeshee, kaliya isku-dayada domain-ka nuqul ka ah ee la diiday ayaa miisaaniyad loo sameeyaa, iyadoo la raacayo qofkii masuulka ahaa. Abuurista guulaysatay weligood lagama qaado kharash — markaa waxaad bixin kartaa tiro badan maalinta oo dhan, baaritaankuna wuxuu dhimanayaa ku dhawaad isla markiiba.
Sedex macaamiil oo leh hal qeexitaan, saddex hab oo shaqo oo kala duwan.
Waxaa loo soo saaray TypeScript, Python, PHP iyo Go, iyadoo la raacayo tilmaamaha si halka laga galo (endpoint) ee cusub uu luqaddaada ugu yimaado adiga oo aan sugin duub gacmeed ah.
WordPress goob ah ka dhis, maxalliga ah uga shaqaysii adigoo aan haysan wax aan ka ahayn Node, kadibna daabac. Zinnector® waxay mashaariicdaada u sii diyaarisaa dhinaca booska aad daabacaysid – nooca PHP, diskiga, tirada faylasha – waxayna ka digaysaa ka hor inta aanad riixin ee ma aha kadib. Sidoo kale waxay gashaa nidaamka, soo bandhigtaa goobaha, daabacdaa, maamushaa domainyada iyo DNS-ka, akhridaa adeegyada iimaylka, samaysaa kaydin, ka shaqaysaa WP-CLI ee liiska ku jira, raadraacdaa diiwaannada, oo fulisaa hawlo badan hal mar. Waa lacag la'aan, shati MIT leh, oo lagu dhisay isla API-gan dadweynaha ee la midka ah.
Maamul mareegaha, domains, diiwaannada DNS, sanduuqyada iเมล-ka iyo qorshayaasha sida kaabayaasha oo ah kood (infrastructure as code). terraform apply waxay bixisaa kaydinta (hosting), deegaannadaaduna waxay noqonayaan kuwo dib loo soo celin karo oo la eegi karo halkii ay ka ahaan lahaayeen taxane guji-guji ah oo aan cidina qorin.
Dukumentiyada la soo saaray ee aad akhrisi kartid oo aad ka wici kartid biraawsarka, iyagoo si sax ah u qeexaya dhamaadka adeegayaasha ay hirgeliyeen — sababtoo ah labaduba waxay ka yimaadaan hal tilmaam.
Madasha gadaasheeda waxaa yaal xuddunta dhacdooyinka adag: isbeddel kasta oo xaalad ah wuxuu qoraa dhacdo sanduuqa wax-ka-baxa ee macaamilka ee Postgres, si atomik ah leh isbeddelka keydka xogta, oo gudbiye ayaa u daabaca NATS JetStream. Dhacdooyinka waa kuwo noocaysan oo leh noocyo kala duwan — site.deployed, order.paid, invoice.overdue, backup.completed, abuse.flagged, trial.ending iyo inta kale.
Diiwaangeli barta dhammaadka ah adoo ah WebhookSubscription oo dooro noocyada dhacdada ee ay helayso. Hal qulqulo ayaa quudisa ogeysiisyada, falanqaynta, otomaatigga iyo is-dhexgalkaaga si siman — waxaad isticmaaleysaa isla dhacdooyinka aan isticmaalno.
Gaarsiis kasta waa mid HMAC-saxiixan si aad u xaqiijiso in ay naga timid ka hor inta aadan tallaabo ka qaadin.
Dirisyadu waxay ku guuldareysteen inay dib u dayraan dib u dhac waxaana isku day kasta loo diiwaangeliyaa WebhookDelivery. Waad baari kartaa oo dib u ciyaari kartaa dirisyada laga soo bilaabo dashboard-ka halkii aad iimayl u diri lahayd taageerada adoo weydiinaya waxa aan dirnay.
Dhuumalku si u kas ah ayuu u yahay ugu yaraan hal mar halkii uu iska dhigi lahaa sax ah hal mar. Kala-gudbiye dhaca inta uu ku jiro daabacaadda ayaa haysata kirada sheegashadiisa oo dhacaysa iyo dhacdooyinkiisa oo dib loo daabacay. Ka jar ID-ga baakadda oo macaamiishaaduna waa sax sida loo dhisay.
API waa kala bar sheekada horumariyaha. Kala bar kalena waa soo rarka.
Waxaan bixinaa madasha anagoo ah adeegye MCP ah oo la martigeliyay: qalab khafiif ah oo protocol ah oo dul taalla engine API kaas oo dib u isticmaalaya buug-gacmeedka ficilka ee la midka ah, RBAC, iyo raadka xisaabinta. Ku xidh Claude Code, Cursor, ChatGPT, Claude Desktop ama macmiil kasta oo MCP awood u leh hal mar, awood kasta oo aan ku darno API-ga waxay si otomaatig ah ugu noqonaysaa mid diyaar u ah.
Ajuanku wuxuu helayaa saddex waxyaabood: Qalabka (isagoo ah halka laga galo API ee isku midka ah, oo aan lahayn loojik barbar-socda oo habowsan), Khayraadka (akhris-bakarriyan ee caafimaadka goobta, habaynta, galalka dillinta ee ugu dambeeyay, halbeegyada, waqtiga shaqada iyo maqaallada KB, si uu ugu baaro xog dhab ah ka hor inta uusan acting sameynin) iyo Prompts (raaddaymo shaqo oo la daabacay sida "baara goobtan" ama "diyaarsha u guuritaanka").
Amnigu waa mid la mid ah xaqiijinta aqoonsiga: OAuth 2.1, calaamado ku xidhan ururkaaga iyo rukumo RBAC iyada oo la fulinayo amniga heerka safka (row-level), oo loo cayimay loona noqon karo qalab kasta, sanduuqa tijaabada (sandbox) oo ka go'an wax-soo-saarka. Falalka wax-duminta ah — tirtirid, ganaax, biilasha, kharashka weyn — waxay u baahan yihiin xaqiijin cad ama siyaasad bini'aadam-ansixin ah. Xadka sicirka iyo xadka kharashka ayaa xaddidaya falalka la bixiyo ee AI-du kiciso, wicitaan kasta oo MCP ahna waxaa lagu diiwaangeliyaa xisaab-xidhka (audit-logged) aqoonsiga, qalabka, doodaha iyo natiijada.
Waxaan taageernaa borotokoolka halkii aan barnaamij kasta si gaar ah u midayn lahayn, taas oo ka dhigan in doorashadaada aaladaha AI ay isbedeli karto iyada oo aan isbedelin is-dhexgalka martigelintaada.
Haa — waa isla engine API-ga, la daabacay oo la adkeeyay. Dashboodka, maamulka console, CLI, Terraform provider, MCP server iyo webhooks dhamaantood waa isticmaalayaasha hal dusha sare, taasina waa sababta aanu API-gu uga dambeyn panel-ka.
Haa. Furayaasha sandbox-ka waxaa loo soo saaraa si gooni ah oo ka duwan furayaasha wax-soo-saarka waxayna ku shaqeeyaan habka tijaabada: ma jiro biil dhab ah mana jiro diyaar-garow dhab ah. Ku hagaaji CI-gaaga aqoonsiyada sandbox-ka oo si ammaan ah u tijaabi codsiga buuxa iyo wareegga jawaabta.
Dir Idempotency-Key fariintaada POST ah. Diiwaanka dib-u-ciyaarka waxaa loo qoraa markii la xaqiijiyo ee ma aha inta ay socoto, markaa dib-u-dayactirku marnaba ma soo celin karo guul la keydiyay oo loogu talagalay saf aan dhab ahaantii xaqiiqo noqon, codsiga guuldarraystana wuxuu sii daayaa xirniinkiisa isla markiiba si aan loo hakin dib-u-dayactirkaaga saxda ah. Keenista Webhook waa ugu yaraan hal mar si loogu talagalay — ka saar nuqullada aqoonsiga baqshadda dhinacaaga.
Maanta maaha. Furayaasha API waxaa loo bixiyaa hab urur kasta ah, sidaas darteed isku-dhafnaanta daboolaysa dhowr urur oo macaamiil ah waxay fure u haysataa urur kasta. Idanka sidoo kale waxaa loo tcheck-greyaa hab urur kasta oo loogu talagalay maamulayaasha isticmaalaha: ku lahaanshaha sites.create urur dhexdiis ma siiso helitaan urur kale oo gaar ah oo aan la xiriirin, ingawa ay ka shaqaynayso ururrada hoos ku dhex jira ururkaas. Taasi waa u kaso - waxay ku xaddidaysaa fure tanaasulay ururkiisa iyo ururrada hoose ee ka hooseeya, ee maaha madalka oo dhan.
Doorka horumariyuhu wuxuu daboolayaa akhriska ururka, maamulka furaha API, daawashada iyo abuurista mareegaha, dib u bilaabidooda, nadiifinta kaydkooda, iyo daawashada iyo ka jawaabista tigidhada. Si ula kac ah ayay uga saaraysaa kontoroolka biilasha. Ogow in ogolaanshaha daabulidda iyo riixida-nool aanay qayb ka ahayn — haddii xubin kooxeed ay u baahan yihiin kuwaas, u qoondee door wata halkii aad u qaadan lahayd in Horumariyuhu yahay door farsamo ee ugu ballaadhan.
Gaarsiisyada ayaa dib loo tijaabiyaa iyadoo la adeegsanayo habka dib u dhaca ee kor u kaca, isku day kasta ayaana loo diiwaangeliyaa sidii WebhookDelivery oo aad baari karto. Dhinaca kale, dhacdooyinka waxaa lagu qoraa outbox macaamil ah isla macaamilka xogta ee isbeddelka laftiisa dhexdiisa, markaa wax lumaya ma jiraan inta macaamiilku maqanyahay — macaamiil hoos u dhacay wuu daahaa, marna ma jebiyo soo-saaraha, waxaanaad dib u soo celin kartaa gaarsiisyada adigoo ka bilaabaya dashboard-ka mar alla markii aad dib u soo noqoto.
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-ga horeeya ee Spec, SDK-yada la sameeyay, CLI, bixiyaha Terraform, webhooks-ka la saxiexay iyo server-ka MCP - oo ku saabsan martigelinta aan u dhisnay in ka badan 650,000 goobood oo adduunka oo dhan ah. Ku bilow tijaabo 14-maalmood ah oo aan kaarka lahayn, oo aan lahayn tafaasiil lacag-bixineed.
Bilow bilaash