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

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

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

Ажиллах зарчмыг тайлбарлахаас өмнө: таны үйлчлүүлэгчид манайхыг хэзээ ч харах шаардлагагүй. Дараах гурван хувилбараас та өөрт тохирохыг сонгоно уу.

| Хувилбар | Хэний өмч вэ | |---|---| | Өөрийн домэйн нэр дээрх хостинг удирдлагын самбар | Дамжуулан борлуулах → Таны брэнд хэсэгт самбарын домэйн нэрийг тохируулснаар таны үйлчлүүлэгчид panel.yourcompany.com хаягаар таны лого, өнгө төрх бүхий самбарт нэвтрэх болно. Ижил удирдлагын самбар, харин таны хаяг. | | Таны өөрийн веб сайт | WordPress залгаас нь таны сайт дээр домэйн хайлтыг байршуулж, нэг даралтаар нэвтрэх холбоосыг үүсгэх бөгөөд захиалгыг таны өөрийн WooCommerce төлбөр тооцооны системээр дамжуулан авна. | | Таны тооцооны систем | WHMCS эсвэл HostBill нь үндсэн нүүр хуудас хэвээр байх бөгөөд модуль нь цаанаа үйлчилгээг тохируулж, хэрэглэгчийн хэсэг дэх товчлуур тэднийг шууд хостинг руу нь нэвтрүүлнэ. |

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

Удирдлагын самбарын домэйн нэрийг нэгэнт тохируулсан бол түүнийг зөвхөн WordPress залгаасын Самбарын хаяг талбарт оруулна уу. Энэхүү API-ийн үүсгэсэн нэвтрэх холбоосууд түүнийг автоматаар дагах болно.

Хогшигдох дөрвөн арга

Дөрвөн өөр арга байгаа бөгөөд тэдгээр нь цаанаа бүгд ижил зарчмаар ажилладаг:

| | Зориулалт | |---|---| | WHMCS модуль | WHMCS дэлгүүрт | | HostBill модуль | HostBill дэлгүүрт | | WordPress залгаас | Өөрийн WordPress эсвэл WooCommerce сайтаас борлуулахад | | API | Бусад бүх системд — Blesta, дотоод систем, cron скрипт |

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

Удирдлагын хэсгийн API түлхүүрүүд цэс рүү орж шинээр үүсгэнэ үү. Түүнд зөвхөн шаардлагатай эрхүүдийг олгоно уу:

| Эрх | Зориулалт | |---|---| | org.read | Үйлчлүүлэгчийн бүртгэлүүдийг унших | | sites.create | Сайт тохируулан үүсгэх | | sites.view | Үйлчилгээний мэдээллийг унших | | sites.delete | Цуцлах | | reseller.view | Үйлчилгээний жагсаалтыг харах болон ашиглалтыг унших | | reseller.provision | Үйлчилгээг түр зогсоох, сэргээх, үйлчлүүлэгчийг нэвтрүүлэх |

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

Түлхүүр зөвхөн нэг удаа харагдана. Түүнийг бусад нууц мэдээллийн нэгэн адил аюулгүй газар хадгална уу — веб серверээс уншиж болохуйц файлд хэзээ ч бүү хадгал.

2. Анхны хүсэлтээ илгээх

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

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

3. Холболтыг бүхэлд нь 6 хүсэлтээр хийх нь

ХЭЗЭЭ                 ХҮСЭЛТ
захиалга төлөгдөхөд   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. Бүртгэлийг үйлчлүүлэгчийнхээ (CUSTOMER) ID-аар, сайтыг үйлчилгээнийхээ (SERVICE) ID-аар тохируул. Үйлчлүүлэгчийн дараагийн захиалга нь тэдний одоо байгаа бүртгэлд харьяалагдах ёстой. Хоёуланг нь үйлчилгээний ID-аар хийвэл нэг үйлчлүүлэгч гурван өөр бүртгэл, гурван тусдаа удирдлагын самбартай болно.
2. Нэг ижил зүйлд өөрийн ID-аар үүсгэсэн Idempotency-Key-ийг POST хүсэлт бүрт илгээ. Тооцооны систем бүр дахин хүсэлт илгээдэг — төлбөрийн системийн дуудлага хоёр удаа ирэх, админ амжилтгүй болсон тохиргоог дахин ажиллуулах, үйлчлүүлэгч хоёр удаа дарах гэх мэт. Энэ түлхүүргүй бол хоёр дахь шийддэл нь дахин нэг сайт үүсгэж, танд нэмэлт төлбөр бодогдоход хүрнэ.

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

• unsuspend нь 409 хариу буцааж болно. Энэ нь та биш, манай зөрчил шалгах баг сайтыг саатуулж байна гэсэн үг юм. Мэдээллийг харуул; дахин хүсэлт бүү илгээ.
• **Үйлчилгээг цуцлах нь шууд устгахгүй, устгахаар төлөвлөнө.** Огноо нь pending_deletion_at гэж буцаж ирнэ. Үйлчлүүлэгчид мэдээлэл нь устаагүй байхад устсан гэж хэлэх нь юу ч хэлээгүйгээс дордно.
• disk_used_bytes нь null байж болно, null нь 0 гэсэн үг биш. Энэ нь бид хэмжиж чадаагүй гэсэн үг болохоос юу ч ашиглаагүй гэсэн үг биш юм. Түүнийг алгасаарай — өөрийн бүртгэлд 0 гэж бүү бич, эс бөгөөс та хэмжилт хийгдээгүй сайтын ашиглалтын индикаторыг үйлчлүүлэгчид ногоон өнгөтэй харуулах болно.

4. Үйлчлүүлэгчийг нэвтрүүлэх

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

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

5. Оронд нь модуль суулгах

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

6. Системээ ашиглалтад оруулах

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

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

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

API-ийн бүрэн шаардлага — шаардлагатай эрх тус бүрийн хамт манай техникийн тодорхойлолтоос үүсгэгдсэн төгсгөлийн цэг бүрийг <https://zinndigital.com/developers/api> хаягаас харна уу.