Өөрийн системээс Zinn® хостинг худалдах

Та манай хостингийг дамжуулан борлуулдаг. Таны харилцагчид таных байх болно: таны үнэ тариф, таны нэхэмжлэх, таны төлбөрийн систем. Та өөрийн ашиглаж буй системүүд болох тооцооны удирдлагын самбар (billing panel), өөрийн WordPress сайт эсвэл скриптээс манай платформыг хэрхэн удирдах арга зам энэ юм.

Таны харилцагчид бодитоор юу харах вэ

Техникийн нарийн зүйлс рүү орохоос өмнө: таны харилцагчид биднийг хэзээ ч харах шаардлагагүй. Хэрэглэгчийн харилцах гурван орчин байгаа бөгөөд та алийг нь ашиглахаа сонгоно.

⛔ Алийг нь ч сонгосон, та бол өөрийн харилцагчдын хувьд албан ёсны борлуулагч (merchant of record) нь юм: таны үнэ, таны нэхэмжлэх, таны НӨАТ-ын дугаар, таны төлбөрийн систем. Бид сард нэг удаа, бөөний үнээр танд нэхэмжлэх илгээнэ.

Удирдлагын самбарын хост нэрийг нэгэнт тохируулсан бол түүнийг зөвхөн WordPress залгаасын Panel address талбарт оруулна уу, өөр хаана ч биш — энэхүү API-аас үүсгэгдэх нэвтрэх холбоосууд уг тохиргоог автоматаар дагана.

Нэвтрэх дөрвөн арга

Нэвтрэх дөрвөн арга байдаг бөгөөд тэдгээр нь бүгд цаанаа ижил үйлдлийг гүйцэтгэдэг:

1. API түлхүүр авах

Хяналтын самбараасаа API keys рүү орж, шинээр үүсгэнэ үү. Зөвхөн шаардлагатай эрхүүдийг олгоно уу:

⛔ Системийн интеграцид reseller.manage эрхийг бүү олгоорой. Энэхүү зөвшөөрөл нь таны үнийн хүснэгт болон таны өөрийн төлбөрийн гарцын итгэмжлэлийг өөрчлөх боломжийг олгодог. Тооцооны удирдлагын самбар эсвэл вэбсайтад хуулж тавих түлхүүрт энэ эрх шаардагдахгүй байх үүднээс л reseller.provision зориулагдсан болно.

Энэхүү түлхүүр нь зөвхөн нэг л удаа харагдана. Үүнийг бусад итгэмжлэлийн мэдээллээ хадгалдаг газартаа хадгална уу — вэб серверээс нийтэд нээлттэй үйлчилдэг файлд хэзээ ч бүү хадгалаарай.

2. Эхний хүсэлтээ илгээх

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

Энэ нь таны үүсгэсэн бүх үйлчилгээг, сайт бүрээр нэг мөр болгон, харьяалагдах харилцагч, түүний төлөв болон таны түүнээс авч буй үнийн хамт буцаана. Шинэ дансанд энэ нь хоосон жагсаалт байх бөгөөд энэ нь алдаа биш, харин зөв хариу юм.

3. Бүрэн интеграци, ердөө зургаан хүсэлтээр

ХЭЗЭЭ                ХҮСЭЛТ
захиалга төлөгдөхөд  POST   /v1/orgs                                   ХАРИЛЦАГЧ тус бүрд нэг удаа
                     POST   /v1/sites                                  ҮЙЛЧИЛГЭЭ тус бүрд нэг удаа
төлбөр төлөгдөөгүй   POST   /v1/reseller/services/{siteId}/suspend
төлбөр төлөгдөхөд    POST   /v1/reseller/services/{siteId}/unsuspend
цуцлах үед           DELETE /v1/sites/{siteId}
"хостинг руу орох"   POST   /v1/reseller/services/{siteId}/sso

Үйлчилгээг тохируулан үүсгэхэд хоёр хүсэлт шаардагдах бөгөөд түлхүүрүүд нь маш чухал ач холбогдолтой:

# 1. харилцагчийн данс — ТАНЫ харилцагчийн id дээр суурилсан түлхүүртэй
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. тэдний сайт — ТАНЫ үйлчилгээний id дээр суурилсан түлхүүртэй
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"}'

Алдвал санхүүгийн зардал гаргах хоёр дүрэм

1. Дансны түлхүүрийг өөрийн ХАРИЛЦАГЧИД, сайтын түлхүүрийг өөрийн ҮЙЛЧИЛГЭЭНД суурилж тохируулна уу. Харилцагчийн хоёр дахь захиалга тэдний аль хэдийн үүссэн дансанд очих ёстой. Хэрэв хоёуланг нь үйлчилгээнд суурилж түлхүүрлэвэл нэг харилцагч хоорондоо холбоогүй гурван данс, тусдаа гурван удирдлагын самбартай болж хоцорно.
2. POST хүсэлт бүрд тухайн зүйлд зориулсан өөрийн id-аас үүсгэсэн Idempotency-Key-г илгээнэ үү. Тооцооны систем бүр дахин хүсэлт илгээдэг — төлбөрийн гарцын callback хоёр удаа ирэх, админ амжилтгүй болсон үйлдлийг дахин ажиллуулах, эсвэл харилцагч товчийг хоёр удаа дарах зэрэг тохиолдол гардаг. Энэхүү түлхүүргүй бол хоёр дахь оролдлого нь дахин нэг сайт шинээр үүсгэх бөгөөд төлбөр нь танаас суутгагдана.

Хоёр сонголт болгон бүдүүлгээр хялбарчилж болохгүй гурван хариу

• unsuspend нь 409 гэсэн хариу буцааж болно. Энэ нь та бус, манай зөрчилтэй тэмцэх баг (abuse team) уг сайтыг түдгэлзүүлсэн гэсэн үг юм. Уг мэдэгдлийг харуулна уу; дахин бүү оролдоорой.
• **Цуцлах үйлдэл нь устгалтыг товлодог, шууд устгадаггүй.** Уг огноо нь pending_deletion_at гэж буцаж ирдэг. Харилцагчид өгөгдөл нь хараахан устаагүй байхад аль хэдийн устсан гэж хэлэх нь юу ч хэлэхгүй байснаас дор юм.
• disk_used_bytes нь null байж болох бөгөөд null нь тэг биш юм. Энэ нь бид хэмжилт хийж чадаагүй гэсэн үг болохоос юу ч ашиглаагүй гэсэн үг биш. Үүнийг алгасна уу — өөрийн бүртгэлд 0 гэж бүү бичээрэй, эс тэгвээс та харилцагчид ямар ч хэмжилтийн утга аваагүй сайтын хувьд ашиглалтын ногоон хэмжүүрийг харуулах болно.

4. Харилцагчийг системд нэвтрүүлэх

POST /v1/reseller/services/{siteId}/sso нь таны харилцагчийг шууд өөрийн данс руу нь, нэвтэрсэн төлөвтэйгээр оруулах нэг удаагийн URL-ийг буцаана.

⛔ Үүнийг харилцагч товчлуур дээр дарах үед л үүсгэх бөгөөд хуудсыг ачаалж харуулах (render) үед хэзээ ч бүү үүсгээрэй. Холбоос нь нэг удаагийн зориулалттай бөгөөд хэдхэн минутын дотор хугацаа нь дуусдаг тул хуудсан дээр шууд бичигдсэн холбоос нь хуудсыг анх нээхэд л хүчингүй болж, та болон хөтчийн хоорондох бүх кэшид (cache) үлддэг.

5. Үүний оронд модуль суулгах

• WHMCS — модулийг modules/servers/zinn/ хавтас руу хуулж, Password нь таны API түлхүүр байх серверийг нэмээд, бүтээгдэхүүн дээр бүтээгдэхүүний ангиллыг (product line) тохируулна уу. Test Connection товчийг дарна уу: энэ нь бодит хүсэлт илгээж, платформ юу гэж хариулсныг танд мэдэгдэнэ.
• HostBill — includes/modules/Hosting/zinn/ хавтас руу хуулж, яг ижил аргаар холбоно уу.
• WordPress — Zinn® Reseller Toolkit: домэйн хайх, харилцагчийн хостинг руу нэвтрэх холбоос, мөн захиалга төлөгдсөн үед WooCommerce тохиргоог автоматаар үүсгэх үйлдэл багтсан. Нээлттэй эх кодтой бөгөөд <https://github.com/Zinn-Digital/zinn-reseller-toolkit> хаягаас авах эсвэл өөрийн хяналтын самбарын Plugins хэсгээс татаж авна уу.

6. Бодитоор ашиглаж эхлэх (Go live)

Бодит захиалга авахаасаа өмнө дараах зүйлсийг шалгана уу:

• Модуль дээрх холболтын шалгалт амжилттай болсон, эсвэл таны эхний curl жагсаалтыг буцааж байгаа эсэх.
• Таны үнийн хүснэгт тохируулагдсан эсэх (Reselling → Your prices).
• Таны төлбөрийн гарц холбогдсон эсэх (Reselling → Payment gateways) — харилцагчид төлбөрөө таны өөрийн дансаар дамжуулан танд төлнө.
• Таны компанийн мэдээлэл орсон эсэх (Reselling → Your company). Ингэснээр таны харилцагчийн нэхэмжлэх дээр биднийх биш, харин таны хуулийн этгээдийн мэдээлэл болон НӨАТ-ын дугаар гарна.
• Та бүх процессын дагуу нэг бодит захиалга туршиж хийж үзсэн бөгөөд сайт амжилттай үүссэнийг шалгасан эсэх.

Бусад бүх мэдээлэл хаана байгаа вэ

Манай техникийн тодорхойлолтоос үүсгэсэн API-ын бүрэн лавлах — төгсгөлийн цэг (endpoint) бүр, тэдгээрт шаардагдах зөвшөөрлийн хамт <https://zinndigital.com/developers/api> хаяг дээр байна.