Fun awọn olùgbélérasùn (developers)
Zinn Digital® jẹ́ pẹpẹ ti a kọ́ lori API. Ẹrọ API kan náà tí ó ń daridaṣbọọdu wa ni eyi ti o gba — pẹlu ẹya, spec-first ati pe a ṣe àkọsílẹ rẹ ni 100% ni akoko iṣelọpọ, pẹlu awọn SDK ti a ṣe, CLI kan, olupese Terraform kan, awọn webhooks ti a fowo si ati olupin MCP kan lori rẹ. Ohunkohun ti o lo lati ṣiṣẹ — ebute kan, opo gigun ti epo, faili ipinlẹ tabi oluranlowo AI kan — pẹpẹ naa dahun si.
Ọ̀pọ̀lọpọ̀ àwọn onílé ẹ̀rọ (hosts) ni wọ́n máa n fi API mọ́ ẹ̀rọ ìṣàkóso lẹ́yìn tí wọ́n ti parí rẹ̀, èyí sì hàn gbangba — ìdajì àwọn ẹ̀yà ẹ̀rọ náà kò sì ní jáde láéláé. A kọ́ ọ lọ́na kejì. Díṣíbọ́ọ̀dù, kọnsọ́lù alákòóso, CLI, olùpèsè Terraform, sẹ́fà MCP àti àwọn ìsopọ̀ ara rẹ gbogbo wọn lo ẹ̀rọ API kan náà. Bí o bá le ṣe é nínú pẹ́ẹ̀lù náà, o lè ṣe é nínú kóòdù.
Ètò OpenAPI ni orísun òtítọ́, kò sì sí ẹnìdípò tí yóò jáde bí kò bá wà nínú ètò náà. Òfin kan ṣoṣo yẹn ni ó mú kí API tí ó wà fún gbogbo ènìyàn ní ìwé àlàyé ní kiko ní àkókò ìkọ́lé dípò kí ó jẹ́ nígbà kan rí — kò sí igun tí kò ní ìwé àlàyé, nítorí pé ẹnìdípò tí kò ní ìwé àlàyé kò le sí.
Àwọn ìwé ìtọ́kasí aláṣẹ, àwọn SDK alágbàtà mẹ́rin, ọ̀pọ̀lọpọ̀ CLI àti ìpìlẹ̀ olùpèsè Terraform ni wọ́n ń ṣe láti inú àlàyé kan náà. Orísun kan, àwọn ohun èlò púpọ̀, nígbà gbogbo ni wọ́n wà ní ìbáṣepọ̀ — o ò ní ní láti lépa ìwé ìtọ́kasí tó ti kúrò níbi ìṣètò rẹ̀ mọ́.
Awọn ipari opopona wa labẹ /v1 pẹlu eto imulo ikọsilẹ ti a tẹjade ati iwe iyipada. Wọn sọ fun ọ ṣaaju ki nkan kan yipada, ni kikọ, kii ṣe wiwa rẹ lati inu ikole ti o kuna.
Àwọn àdánwò àdéhùn ìṣirò lòdì sí àpẹẹrẹ àti ìtẹ̀sí OpenAPI ń ṣiṣẹ́ lórí gbogbo àtúnṣe. Ìyapa láàárín kóòdù àti àdéhùn náà ń sọ ìkọ́lé náà di aṣìṣe — nítorí náà àpẹẹrẹ tí o fi ń mú kí oníbàárà rẹ jáde ni àpẹẹrẹ tí sínfà náà ń bọ̀wọ̀ fún ní tòótọ́.
Ọ̀nà méjì ni ó wọlé, ìlànọ́ kan náà sì wà lẹ́yìn wọn. Èyíkéyìí tí o bá lò, àwọn àyẹ̀wò ìyọǹda kan náà àti ìpínlẹ̀ ní ipò ibùpamọ́ dátà kan náà ni yóò wúlò.
Awọn bọtini dabi zdk_<mode>_<prefix>_<secret>. Hash SHA-256 nikan ti ohun aṣiri naa ni a n fipamọ — a ko le fi bọtini kan han ọ lẹẹkan si lẹhin ti a fun ọ ni, bẹẹ ni ẹnikẹni ti o ba wọle si ibi ipamọ data wa ko le ṣe bẹ náà. Awọn bọtini ni awọn ipa (scopes), a le fagile wọn, a si n funni ni wọn fun agbari kan kọọkan dipo fun ẹni kọọkan.
Àwọn bọ́tìnnì ìdánwò (sandbox keys) yàtọ̀ sí àwọn bọ́tìnnì ìṣelọpọ (production keys) wọ́n sì ń ṣiṣẹ́ lórí ipò ìdánwò: kò sí ìgbówó tòótọ́, kò sì sí ìpèsè tòótọ́. Àwọn ìdánwò ìṣọ̀kan rẹ lè lo API náà láìná owó tàbí láìkọ́ àwọn sẹ̀fà (servers).
Àwọn àpjọ olùlò máa ń jẹ́ ìdánimọ̀ pẹ̀lú Keycloak-issued JWTs, tí a ti mọ̀ dájú lòdì sí kọ́kọ́rọ́ gbogbo gbogbo ti ìjọba, wọ́n sì ń yanjú sí nǹkan Principal kan náà tí kọ́kọ́rọ́ API kan ṣe. Àwọn ẹnubodè wà lórí àwọn kọ́kọ́rọ́ àṣẹ kíkún gẹ́gẹ́ bí sites.create tàbí apikeys.manage, tí a ń yẹ̀ wò fún àjọ kọ̀ọ̀kan — àṣẹ kan nínú àjọ kan kò fúnni ní ààyè wọlé nínú àjọ mìíràn tí kò ní í ṣe pẹ̀lú rẹ̀, bí ó tilẹ̀ jẹ́ pé ó kan àwọn àjọ tí ó wà lábẹ́ rẹ̀.
Gbogbo ibeere oluyalo ni o n ṣiṣẹ ninu gbigbe iṣowo kan pẹlu iwọn ajo Postgres ti a ṣeto lati ọdọ oludari, nitorinaa ipinya ni a fi agbara mu nipasẹ data-busi, kii ṣe nipasẹ asẹ ORM ti ẹnikan le gbagbe. Asẹ queryset tun wa nibẹ gẹgẹbi aabo ni jinlẹ.
Ó rọ́pọ̀ láti mú kí API kan dára nínú README ṣùgbọ́n ó nira láti jẹ́ kí ó hùwà déédéé lábẹ́ ìṣàn ìjábọ̀ gidi. Èyí ni àwọn apá tí a fojú kọ̀ gbóná, nítorí pé wọ́n jẹ́ àwọn apá tíó ń fọ́ àwọn ìṣọ̀kan ní aago mẹ́ta òwúrọ̀.
Agbaye kan ti o yẹ fun akiyesi, nitori pe o n ṣe apẹrẹ bi iṣẹ opopo ṣe n ṣiṣẹ: 409 lori ašẹ ti o jẹ meji n da bi "njẹ a ṣe alejo gbigba orukọ ile-iṣẹ yi ni ibi?" fun alagbeegbe eyikeyi, eyiti o jẹ alaye ti o le ṣafihan nkan ti o wa ni ipamọ ati eewu gidi lati mọ ẹni ti o jẹ si Footprint-Free. Didasi idaduro fun idasile aaye ti yoo jẹ atunṣe ti o rọrun jù ati pe yoo ti ba ọja ti o n pese opopo jẹ patapata. Bẹni dipo eyi, awọn gbiyanju aṣẹ ti o jẹ meji ti a kọ silẹ nikan ni a n ṣeto opamọ fun, fun oludasile kọọkan. Awọn idasile ti o ṣe aṣeyọri kii ṣe ohun ti a n gba ebute lori rẹ lailai — nitori na o le pese ni opopo ni gbogbo ọjọ, ati pe igbiyanju lati mọ ohun ti o wa ninu rẹ n ku fere lẹsẹkẹsẹ.
Àwọn oníbàárà mẹ́ta fún ìwọ̀n kan náà, fún ọ̀nà mẹ́ta ọ̀tọ̀ọ̀tọ̀ tí wọ́n fi ń ṣiṣẹ́.
A ti ṣe agbekalẹ rẹ̀ fún TypeScript, Python, PHP ati Go, ti o n tẹle ìlànà naa ki ohun elo tuntun kan le de si ede rẹ laisi idaduro lori àkópọ̀ ti a fi ọwọ́ kọ.
Gbe aaye WordPress kan kalẹ, jẹ ki o ṣiṣẹ ni agbegbe pẹlu ohunkohun ti ko ni fi sori ẹrọ bikoṣe Node, ki o si gbe e sori ẹrọ. Zinnector® ṣe idanwo iṣẹ-ṣiṣe rẹ ni ilosiwaju lodi si iho ti o fẹ gbe sori rẹ — ẹya PHP, disiki, iye faili — o si n kilọ ṣaaju ki o to Titari dipo lẹhin. O tun wọle, ṣe atهو iṣẹ fun awọn aaye, gbe sori ẹrọ, ṣakoso awọn agbegbe ati DNS, ka awọn iṣẹ imeeli, gba awọn afẹyinti, nṣiṣẹ WP-CLI ti a fọwọsi, tẹle awọn akọọlẹ ati ina awọn iṣẹ olopobobo. Ọfẹ, ti a fun ni iwe-aṣẹ MIT, ati ti a kọ sori API gbangba yii kanna.
Ṣàkóso àwọn ojúlé, àwọn agbègbè, àwọn ìpamọ́ DNS, àwọn àpótí ìfiránṣẹ́ àti àwọn ètò gẹ́gẹ́ bí ìmọ̀ ẹ̀rọ bí àwọn ohun èlò koodu (infrastructure as code). terraform apply máa ń pèsè ìgbékalẹ̀ ayika ìgbékalẹ̀, àwọn àyíká rẹ sì máa ń di ohun tí a lè tún ṣe àti àyẹ̀wò dípò ọ̀wọ́ àwọn à Tẹ́ kò sí ẹni tí ó kọ sílẹ̀.
Awọn iwe aṣẹ ti o ti ni ipilẹṣẹ ti o le ka ti o si pe lati ẹrọ aṣawakiri, ti n ṣapejuwe gangan awọn ipari ibi ti sẹ́fà nṣe — nitori pe mejeeji wa lati inu sipesifikesonu kanna.
Lẹhin pẹpẹ ni ẹhin olutọpa iṣẹlẹ ti o tọ: gbogbo iyipada ipo n kọ iṣẹlẹ kan si apoti iṣẹlẹ idasile ni Postgres, pẹlu iyipada data ibi ipamọ ni apapọ, ati ẹrọ gbigbe kan n tẹ e jade si NATS JetStream. Awọn iṣẹlẹ ni iru ati ẹya — site.deployed, order.paid, invoice.overdue, backup.completed, abuse.flagged, trial.ending ati awọn iyokù.
Forukọsilẹ ibi-aago kan gẹgẹbi WebhookSubscription ki o si yan awọn iru iṣẹlẹ ti yoo gba. Ìṣàn kan na ni o n pese awọn iwifunni, iṣayẹwo data, awọn eto laifọwọyi ati iṣọpọ rẹ — o n jẹ awọn iṣẹlẹ kan na ti a n lo pẹlu.
Gbogbo ìfiṣẹ́ṣe ni wọ́n fi HMAC tọwọ́ bọ̀ ọ kí o lè mọ̀ dájúdájú pé wọ́n wá láti ọ̀dọ̀ wa ṣáájú kí o tó ṣe ohun kankan lórí rẹ̀.
Awọn ifijiṣẹ ti o kuna tun gbiyanju pẹlu sẹhin ati pe igbiyanju kọọkan jẹ igbasilẹ bi WebhookDelivery. O le ṣayẹwo ati tun ṣe awọn ifijiṣẹ lati inu dasibodu dipo fifiranṣẹ imeeli si atilẹyin lati beere ohun ti a ranṣẹ.
Ọ̀nà ìṣàn náà mọ̀ọ́mọ̀ jẹ́ nígbà-kẹ́gbà ju pé kí ó máa sìn ẹ̀gàn bí ẹni pé ó jẹ́ lẹ́ẹ̀kan ṣoṣo. Alákọ̀ọ́ṣẹ̀ tàbí afúnni kan tí ó kú ní àárín ìtẹ̀jáde ní àǹfààní ẹ̀tọ́ rẹ̀ tí ó parí àti àwọn ìṣẹ̀lẹ̀ rẹ̀ tí a tún tẹ̀jáde. Ṣe ìyọkuro ẹ̀da lórí ID àpamọ́ náà àti pé olùrà fún un rẹ péye nípasẹ̀ ìkọ́lé.
Àpẹẹrẹ API kan jẹ́ ìdajì ìtàn olùgbékalẹ̀ sọfitiwia kan péré. Ìdajì yòókù ni ìfifiranṣẹ́ rẹ̀ síta.
A n ṣe àفihàn pẹpẹ náà gẹgẹ bí olùṣèṣe MCP tí a gbalejo: àwọn olùbámu ìlànà tinrin lórí ėni API náà tí ó tún lo katalogi iṣẹ́ kanna náà, RBAC àti àkọsílẹ̀ àyẹ̀wò. So Claude Code, Cursor, ChatGPT, Claude Desktop tàbí èyíkéyìí alabara tí ó lẹ́gbẹ́ MCP pọ̀ lẹ́ẹ̀kan, yóò sì jẹ́ pé gbogbo agbára tí a fi kún API náà yóò wà fún un láìsí ìṣòro.
Aṣojú náà gba ohun mẹ́ta: Àwọn irinṣẹ́ (àwọn àbájáde API kan náà, kò sí ìlànà ìṣiṣẹ́ afikọ̀ to lè yapa), Àwọn ohun àmúṣẹ́ (ìlera ojú-wẹ́bù tí a lè kà nìkan, àwọn ìtòsí, àwọn àkọsílẹ́ àìpẹ́ yìí, àwọn ìwọ̀n, àkókò ìṣiṣẹ́ ati àwọn àpilẹ̀kọ KB, nitorinaa o fi gidi dánwò ṣáájú kí o tó gbé ìgbésẹ̀) àti Àwọn Ìtọ́ni (àwọn àwòṣe ìṣàn iṣẹ́ tí a tẹ̀ jade gẹ́gẹ́ bí "ṣàyẹ̀wò ojú-wẹ́bù yìí" tàbí "pèsè ìṣípò aṣà sílẹ̀").
Aabo jẹ itan kan naa bi idanimọ: OAuth 2.1, awọn ami idanimọ ti o ni asopọ si ajo rẹ ati awọn ẹnikan RBAC pẹlu aabo ipele-tẹmpili ti a fi agbara mu, ti a fi opin si ati ti o le sọ di asan fun irinṣẹ kọọkan, apoti iyanrin ti ya sọtọ kuro ni iṣelọpọ. Awọn iṣe iparun — nu, daduro, ìgbèšẹ, inawo nla — nilo ifọwọsi kedere tabi ilana iṣe ifọwọsi eniyan. Awọn opin oṣuwọn ati awọn opin inawo niasopọ awọn iṣe ti a sanwo ti AI nfa, ati pe a nṣe akọọlẹ ayewo fun gbogbo ipe MCP pẹlu idanimọ, irinṣẹ, awọn ariyanjiyan ati abajade.
A n ṣe àtìlẹ́yìn fún ìlànà náà dípò kí a sọ̀ kalẹ̀ sórí ohun èlò kọ̀ọ̀kan ní ẹ̀kan náà, èyí tí ó túmọ̀ sí pé ìyànjú ríru irinṣẹ́ AI rẹ le yípadà láìsí pé ìsopọ̀ gbígbé aáyè rẹ yípadà pẹ̀lú rẹ̀.
Bẹẹni — o jẹ engine API kanna, ti a ṣe jade ti o si ni agbara. Awọn daṣibọọdu, iṣakoso alabojuto, CLI, olupese Terraform, ṣeeva MCP ati awọn webhooks jẹ gbogbo awọn olumulo ti oju kanṣoṣo, eyiti o jẹ idi ti API ko fi wa sẹyin panẹli naa.
Bẹẹni. A ń pèsè àwọn bọ́tìnnì ìdánwò (sandbox keys) ní sọ́tọ̀ kúrò lọ́dọ̀ àwọn bọ́tìnnì ìṣóòṣì (production keys) wọ́n sì ń ṣiṣẹ́ nípò ìdánwò: kò sí ìgbówó tàbí ìpèsè gidi kankan. Fi àwọn ẹ̀rí ìdánwò rẹ sọ́dọ̀ CI kí o sì ṣe àyẹ̀wò ìbéèrè àti ìdáhùn ní kíkún láìséwu.
Fi Idempotency-Key ranṣẹ lori POST rẹ. A kọ igbasilẹ ìmúdàgba naa nigbati a ba ṣe ifaramọ kii ṣe ni afikun, nitorinaa atunṣe ko le tun mu aṣeyọri ti a fipamọ sori ẹrọ fun ila kan ti ko ṣe ifaramọ ni otitọ, ati pe ibeere ti o kuna tu titiipa rẹ silẹ lẹsẹkẹsẹ ki atunṣe ti a ṣe atunṣe rẹ ko ba dimọ. Ifijiṣẹ Webhook jẹ o kere ju lẹẹkan nipasẹ apẹrẹ - dedupe lori ID apoowe ni ipari rẹ.
Ko si loni. Awọn bọtini API ni a n pese fun ajo kọọkan, nitorina iṣọpọ kan ti o gba awọn ajo onibara pupọ mu bọtini kan fun ọkọọkan wọn. A tun n ṣayẹwo awọn aṣẹ fun ajo kọọkan fun awọn olumulo akọkọ: mimu sites.create ni ajo kan ko fun ni iraye si ni ajo miiran ti ko ni ibatan, botilẹjẹpe o kan awọn ajo ti o wa labẹ eyẹn. Eyi jẹ ohun ti a gbero — o fi bọtini ti o ni ipalara pamọ si ajo rẹ ati awọn abẹ-ajo ti o wa labẹ rẹ, kii ṣe gbogbo pẹpẹ naa.
Ipa olùgbérò náà ni ìkàwé àjọ, ìṣàkóso bọ́tìnnì API, wíwo àti ṣíṣẹ̀dá àwọn ojú-wẹ́bù, títún wọn bẹ̀rẹ̀, fífọ́ àwọn cache wọn, àti wíwo àti ìdáhùn sí àwọn tíkẹ́tì. Ó mọ̀ọ́mọ̀ yọ ìṣàkóso ìṣúná sílẹ̀. Kíyè sí i pé àwọn àṣẹ ìgbéjáde àti ìta-sí-àyè kò jẹ́ apá kan rẹ̀ — bí ọmọ ẹgbẹ́ kan bá nílò àwọn wọ̀nyí, fi ipa kan tí ó ní wọ́n lé e lọ́wọ́ dípò kí a rò pé Olùgbérò ni ipa ìmọ̀-ẹ̀rọ tí ó gbòòrò jù lọ.
Àwọn ìgbìyànjú ìfiṣẹ́ṣọ̀wọ́ padà wọlé pẹ̀lú ìdúróṣinṣin tí ó ń pọ̀ sí i, a sì ń gba ìgbìyànjú kọ̀ọ̀kan sílẹ̀ gẹ́gẹ́ bíi WebhookDelivery tí o lè yẹ̀wò. Loke, a kọ àwọn ìṣẹ̀lẹ̀ sínú outbox ìdúsoro nínú ìdúsoro ìpamọ́ kan náà gẹ́gẹ́ bí ìyípadà fúnra rẹ̀, nitorinaa kò sí ohun tí ó sọnù nígbà tí olùlò kò ní ààyè — olùlò tó wà ní ìsàlẹ̀ máa ń lọ́ra, kì í phá olùṣe náà, o sì lè tún ìfiṣẹ́ṣọ̀wọ́ ṣe láti inú daṣibọọ̀dù nígbà tí o bá padà dé.
Bẹrẹ ìdánwò ọjọ́ 14 lórí Footprint-Free Hosting láìní káàdì – kò sí àwọn alaye ìsanwó, ó tó àwọn ojú ògùn 5. Awọn ipele Footprint-Free ti a sanwo bẹrẹ ni $6/mo fun PBN 5. Eto kọọkan ni iṣeduro ifẹ agbapada ọjọ 30, awọn iṣimbẹ ọfẹ ati pe ko si titiipa olutaja.
API ti o kọkọ da lori ilana (spec-first), awọn SDK ti a ṣe, CLI kan, olupese Terraform kan, awọn webhooks ti a fowo si ati olupersi MCP kan — lori gbigbalejo wẹẹbu ti a kọ fun awọn aaye 650,000+ ni agbaye. Bẹrẹ lori idanwo ọjọ 14 ti ko nilo kaadi, ko si awọn alaye isanwo ti o nilo.
Bẹrẹ lọ́fẹ̀ẹ́