Títà alejo gbigbale Zinn® lati awọn eto tirẹ

Ẹ tún gbàlejò (hosting) wa tà. Àwọn oníbàárà yín jẹ́ tiyín: àwọn iye owó yín, àwọn ìwé-owó yín, olùpèsè ìsanwó yín. Èyí ni ọ̀nà tí ẹ gbà ń darí pèpéle wa láti ohunkóhun tí ẹ ti ń lò tẹ́lẹ̀ — páńẹ́ẹ̀lì ìṣirò-owó, ojúlé wẹ́ẹ̀bù WordPress tiyín gan-an, tàbí àkójọ-àṣẹ (script).

Ohun tí àwọn oníbàárà yín ń rí ní ti gidi

Kí a tó bọ́ sí ti ìmọ̀ ẹ̀rọ: kò pọndandan fún àwọn oníbàárà yín láti rí wa láéláé. Ojú mẹ́ta ló wà, ẹ sì lè yan èyí tí ẹ máa lò.

⛔ Èyíkéyìí tí ẹ bá yàn, ẹ̀yin ni oníṣòwò tí ó wà lákọsílẹ̀ fún àwọn oníbàárà yín: àwọn iye owó yín, àwọn ìwé-owó yín, nọ́mbà VAT yín, olùpèsè ìsanwó yín. Àwa ń fi ìwé-owó ránṣẹ́ sí ẹ̀yin, lẹ́ẹ̀kan lóṣù, ní owó àpápọ̀.

Nígbà tí ẹ bá ti ṣètò orúkọ-olùgbàlejò páńẹ́ẹ̀lì kan, ẹ fi sí pápá Àdírẹ́sì páńẹ́ẹ̀lì ti àtìpọ̀ WordPress náà tí ẹ kò sì gbọdọ̀ fi sí nǹkan mìíràn — àwọn ọ̀nà-ìjápọ̀ ìwọlé tí API yìí ń ṣe yóò tẹ̀lé e fúnra wọn.

Àwọn ọ̀nà mẹ́rin láti wọlé

Àwọn ọ̀nà mẹ́rin ló wà láti wọlé, gbogbo wọn sì ń ṣe ohun kan náà ní abẹ́nú:

1. Gba kọ́kọ́rọ́ API kan

Ní ibi-ìṣàkóso (dashboard) yín, ẹ lọ sí Àwọn kọ́kọ́rọ́ API kí ẹ sì dá ọ̀kan sílẹ̀. Ẹ fún un ní ohun tí ó nílò nìkan:

⛔ Ẹ má ṣe fún ìṣọ̀kan (integration) kan ní reseller.manage. Àṣẹ yẹn ń ṣàtúnṣe àkójọ iye owó yín àti àwọn ẹ̀rí-ìdánimọ̀ ọ̀nà-ìsanwó tiyín gan-an. reseller.provision wà nítorí kí kọ́kọ́rọ́ tí ẹ lẹ̀ sínú páńẹ́ẹ̀lì ìṣirò-owó tàbí ojúlé wẹ́ẹ̀bù kan má bàa nílò rẹ̀.

Lẹ́ẹ̀kan ṣoṣo ni a ń fi kọ́kọ́rọ́ náà hàn. Ẹ tọ́jú rẹ̀ sí ibi tí ẹ ń tọ́jú àwọn ẹ̀rí-ìdánimọ̀ yín mìíràn sí — ẹ má ṣe fi sí inú fáìlì tí ẹ̀rọ-ìpèsè wẹ́ẹ̀bù yín ń pèsè fún gbogbo ènìyàn láéláé.

2. Ṣe ìpè àkọ́kọ́ yín

curl https://api.zinndigital.com/v1/reseller/services \
  -H "Authorization: Bearer zdk_live_…"

Ìyẹn yóò dá gbogbo iṣẹ́-ìpèsè tí ẹ ti pèsè padà, ìlà kan fún ojúlé kọ̀ọ̀kan, pẹ̀lú oníbàárà tí ó ni ín, ipò rẹ̀, àti iye tí ẹ ń gbà lórí rẹ̀. Lórí àkópọ̀-ìwé tuntun, àkójọ òfo ni yóò jẹ́ — èyí tí í ṣe èsì tí ó tọ́, kì í ṣe àṣìṣe.

3. Gbogbo ìṣọ̀kan náà, nínú ìpè mẹ́fà

NÍGBÀ TÍ              ÌPÈ
a bá sanwó àṣẹ kan   POST   /v1/orgs                                   lẹ́ẹ̀kan fún ONÍBÀÁRÀ kọ̀ọ̀kan
                     POST   /v1/sites                                  lẹ́ẹ̀kan fún IṢẸ́-ÌPÈSÈ kọ̀ọ̀kan
wọn kò tíì sanwó     POST   /v1/reseller/services/{siteId}/suspend
wọ́n sanwó            POST   /v1/reseller/services/{siteId}/unsuspend
wọ́n fagilé           DELETE /v1/sites/{siteId}
"wọlé sí gbàlejò"    POST   /v1/reseller/services/{siteId}/sso

Ìpè méjì ni ìpèsè, àwọn kọ́kọ́rọ́ náà sì ṣe pàtàkì:

# 1. àkópọ̀-ìwé oníbàárà náà — tí a fi nọ́mbà-ìdánimọ̀ oníbàárà TIYÍN ṣe kọ́kọ́rọ́ fún un
curl -X POST https://api.zinndigital.com/v1/orgs \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: account-4211" \
  -d '{"type":"customer","name":"Acme Ltd"}'

# 2. ojúlé wọn — tí a fi nọ́mbà-ìdánimọ̀ iṣẹ́-ìpèsè TIYÍN ṣe kọ́kọ́rọ́ fún un
curl -X POST https://api.zinndigital.com/v1/sites \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: service-9915" \
  -d '{"org_id":"<from step 1>","product_line":"mainstream","primary_domain":"acme.com"}'

Àwọn òfin méjì tí ń ná yín lówó nígbà tí ẹ bá ṣe wọ́n ní àṣìṣe

1. Ẹ fi ONÍBÀÁRÀ yín ṣe kọ́kọ́rọ́ fún àkópọ̀-ìwé náà àti IṢẸ́-ÌPÈSÈ yín fún ojúlé náà. Àṣẹ kejì ti oníbàárà kan gbọdọ̀ wọ inú àkópọ̀-ìwé tí wọ́n ti ní tẹ́lẹ̀. Tí ẹ bá fi iṣẹ́-ìpèsè náà ṣe kọ́kọ́rọ́ fún méjèèjì, oníbàárà kan yóò wá ní àwọn àkópọ̀-ìwé mẹ́ta tí kò tan mọ́ ara wọn àti páńẹ́ẹ̀lì ọ̀tọ̀ọ̀tọ̀ mẹ́ta.
2. Ẹ fi Idempotency-Key ránṣẹ́ lórí gbogbo POST, tí a kọ́ láti inú nọ́mbà-ìdánimọ̀ tiyín fún ohun náà. Gbogbo ètò ìṣirò-owó ló ń tún gbìyànjú — ìpadàbọ̀ ọ̀nà-ìsanwó máa ń dé lẹ́ẹ̀mejì, olùṣàkóso kan ń tún ìpèsè tí kò yege ṣe, oníbàárà kan tẹ bọ́tìnì lẹ́ẹ̀mejì. Láìsí kọ́kọ́rọ́ náà, ìgbìyànjú kejì yóò dá ojúlé kejì sílẹ̀, a ó sì fi ìwé-owó rẹ̀ ránṣẹ́ sí yín.

Àwọn èsì mẹ́ta tí ẹ kò gbọdọ̀ dín kù sí méjì

• unsuspend lè dá 409 padà. Ìyẹn túmọ̀ sí pé ẹgbẹ́ àbójútó-ìlòkulò wa ló di ojúlé náà mú, kì í ṣe ẹ̀yin. Ẹ fi ìránṣẹ́ náà hàn; ẹ má ṣe tún un gbìyànjú.
• **Fífòpin-sí máa ń ṣètò ìparẹ́ sílẹ̀ ni, kò kì í ṣe é lẹ́sẹ̀kẹsẹ̀.** Ọjọ́ náà máa ń padà wá bíi pending_deletion_at. Sísọ fún oníbàárà pé àwọn dátà wọn ti lọ kúrò nígbà tí kò rí bẹ́ẹ̀ burú ju kí ẹ má sọ ohunkóhun fún wọn lọ.
• disk_used_bytes lè jẹ́ null, null kì í sì í ṣe oókan. Ó túmọ̀ sí pé a kò lè wọn ònkà rẹ̀, kì í ṣe pé a kò lo ohunkóhun. Ẹ fo èyí — ẹ má ṣe kọ 0 sínú àwọn àkọsílẹ̀ tiyín fúnra yín, bí bẹ́ẹ̀ kọ́ ẹ ó fi igi ìlò aláwọ̀ ewé hàn oníbàárà fún ojúlé tí ẹ kò ní àkọsílẹ̀ kankan láti inú rẹ̀.

4. Mú oníbàárà kan wọlé

POST /v1/reseller/services/{siteId}/sso máa ń dá URL ìlò-lẹ́ẹ̀kan-ṣoṣo padà tí ó ń mú oníbàárà yín lọ tààràtà sínú àkópọ̀-ìwé tiwọn fúnra wọn, tí wọ́n sì ti wọlé tẹ́lẹ̀.

⛔ Ẹ ṣe é jáde nígbà tí wọ́n bá tẹ̀ ẹ́, ẹ má ṣe ṣe é nígbà tí ẹ bá ń gbé ojú-ewé náà jáde láéláé. Ọ̀nà-ìjápọ̀ náà wà fún ìlò-lẹ́ẹ̀kan-ṣoṣo ó sì máa ń parí láàárín ìṣẹ́jú díẹ̀, nítorí náà ọ̀nà-ìjápọ̀ tí a kọ sínú ojú-ewé kan máa ń jóná ní ìwò-ojú-ewé àkọ́kọ́ a sì fi sílẹ̀ nínú gbogbo ibi-ìfipamọ́ (cache) tí ó wà láàárín yín àti aṣàwákiri náà.

5. Ẹ fi ẹ̀yà-ara (module) sípò dípò èyí

• WHMCS — ẹ ṣe àwòkọ ẹ̀yà-ara náà sí modules/servers/zinn/, ẹ fi ẹ̀rọ-ìpèsè kan kún un tí Ọ̀rọ̀-ìgbaniwọlé rẹ̀ jẹ́ kọ́kọ́rọ́ API yín, kí ẹ sì ṣètò ìlà ọjà náà lórí ọjà náà. Ẹ tẹ Dán Ìsopọ̀ Wò: ó ń ṣe ìpè gidi kan ó sì ń sọ ohun tí pèpéle náà sọ fún yín.
• HostBill — ẹ ṣe àwòkọ sí includes/modules/Hosting/zinn/ kí ẹ sì so ó pọ̀ ní ọ̀nà kan náà.
• WordPress — Zinn® Reseller Toolkit: àwárí orúkọ-àkájọ, ọ̀nà-ìjápọ̀ ìwọlé sínú gbàlejò àwọn oníbàárà yín, àti ìpèsè WooCommerce nígbà tí a bá sanwó àṣẹ kan. Ó jẹ́ orísun ṣíṣí ní <https://github.com/Zinn-Digital/zinn-reseller-toolkit>, tàbí kí ẹ gbà á wọlé láti Àwọn àtìpọ̀ ní ibi-ìṣàkóso yín.

6. Bẹ̀rẹ̀ ní tààràtà (Go live)

Ẹ ṣàyẹ̀wò àwọn wọ̀nyí kí ẹ tó gba àṣẹ-ìrajà gidi kan:

• Ìdánwò ìsopọ̀ náà yege lórí ẹ̀yà-ara náà, tàbí curl àkọ́kọ́ yín dá àkójọ kan padà.
• A ti ṣètò àkójọ iye owó yín (Títún-tà → Àwọn iye owó yín).
• Ọ̀nà-ìsanwó yín ti sopọ̀ (Títún-tà → Àwọn ọ̀nà-ìsanwó) — àwọn oníbàárà yín ń sanwó fún yín, nípasẹ̀ àkópọ̀-ìwé tiyín fúnra yín.
• Àwọn ẹ̀kúnrẹ́rẹ́ ilé-iṣẹ́ yín ti wà nínú rẹ̀ (Títún-tà → Ilé-iṣẹ́ yín) kí àwọn ìwé-owó oníbàárà yín lè gbé àjọ tó bá òfin mu àti nọ́mbà VAT tiyín, kì í ṣe tiwa.
• Ẹ ti ṣe àṣẹ gidi kan láti ìbẹ̀rẹ̀ dé òpin tí ẹ sì rí i tí ojúlé náà jáde.

Ibi tí gbogbo nǹkan mìíràn wà

Ìtọ́kasí API lẹ́kùn-únrẹ́rẹ́ — gbogbo ibi-ìparí (endpoint), tí a pèsè láti inú àpèjúwe wa, pẹ̀lú àṣẹ tí ọ̀kọ̀ọ̀kan nílò — wà ní <https://zinndigital.com/developers/api>.