Zinn® hostinqinin öz sistemlərinizdən satışı

Siz bizim hostinqimizi yenidən satırsınız. Müştəriləriniz sizindir: sizin qiymətləriniz, sizin hesab-fakturalarınız, sizin ödəniş təminatçınız. Platformamızı artıq işlətdiyiniz hər hansı bir sistemdən — hesablaşma panelindən, öz WordPress saytınızdan və ya bir skriptdən idarə etməyin yolu budur.

Müştərilərinizin faktiki olaraq gördükləri

Mexanizmlərdən əvvəl: müştəriləriniz bizi heç vaxt görməməlidir. Üç interfeys var və siz hansından istifadə edəcəyinizi seçirsiniz.

⛔ Hansını seçməyinizdən asılı olmayaraq, siz müştəriləriniz üçün rəsmi satıcısınız: sizin qiymətləriniz, sizin hesab-fakturalarınız, sizin ƏDV nömrəniz, sizin ödəniş təminatçınız. Biz sizə ayda bir dəfə, topdansatış qiyməti ilə hesab təqdim edirik.

Panel host adını təyin etdikdən sonra onu yalnız WordPress qoşmasının Panel ünvanı sahəsinə daxil edin — bu API-nin yaratdığı daxilolma keçidləri avtomatik olaraq onu izləyir.

Dörd giriş yolu

Dörd giriş yolu var və onların hamısı arxa planda eyni işi görür:

1. API açarı əldə edin

İdarəetmə panelinizdə API açarları bölməsinə keçin və birini yaradın. Ona yalnız ehtiyacı olan icazələri verin:

⛔ İnteqrasiyaya reseller.manage icazəsi verməyin. Bu icazə qiymət siyahınızı və şəxsi ödəniş şlüzü məlumatlarınızı redaktə edir. reseller.provision məhz ona görə mövcuddur ki, hesablaşma panelinə və ya veb-sayta yerləşdirdiyiniz açarın buna ehtiyacı olmasın.

Açar bir dəfə göstərilir. Onu digər giriş məlumatlarınızı saxladığınız yerdə saxlayın — heç vaxt veb-serverinizin təqdim etdiyi faylda saxlamayın.

2. İlk çağırışınızı edin

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

Bu, təmin etdiyiniz hər bir xidməti, hər sayt üçün bir sətir olmaqla, aid olduğu müştəri, statusu və bunun üçün tələb etdiyiniz məbləğlə birlikdə qaytarır. Yeni hesabda bu boş bir siyahıdır — bu xəta deyil, düzgün cavabdır.

3. Bütün inteqrasiya, altı çağırışda

NƏ VAXT               ÇAĞIRIŞ
sifariş ödənildikdə   POST   /v1/orgs                                   MÜŞTƏRİ başına bir dəfə
                     POST   /v1/sites                                  XİDMƏT başına bir dəfə
ödəmədikdə           POST   /v1/reseller/services/{siteId}/suspend
ödədikdə             POST   /v1/reseller/services/{siteId}/unsuspend
ləğv etdikdə         DELETE /v1/sites/{siteId}
"hostinqə daxil ol"  POST   /v1/reseller/services/{siteId}/sso

Təminat iki çağırışdan ibarətdir və açarlar vacibdir:

# 1. müştərinin hesabı — SİZİN müştəri identifikatorunuza bağlıdır
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. onların saytı — SİZİN xidmət identifikatorunuza bağlıdır
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"}'

Səhv etdiyiniz halda sizə baha başa gələcək iki qayda

1. Hesabı MÜŞTƏRİNİZƏ, saytı isə XİDMƏTİNİZƏ bağlayın. Müştərinin ikinci sifarişi artıq malik olduğu hesaba daxil olmalıdır. Hər ikisini xidmətə bağlasanız, bir müştəri üç əlaqəsiz hesaba və üç ayrı panelə sahib olacaq.
2. Hər bir POST sorğusunda obyekt üçün öz şəxsi identifikatorunuzdan qurulmuş Idempotency-Key göndərin. Hər bir hesablaşma sistemi təkrar cəhd edir — şlüzün geri çağırışı iki dəfə gəlir, administrator uğursuz təminatı yenidən icra edir, müştəri iki dəfə klikləyir. Açar olmadıqda, ikinci cəhd ikinci sayt yaradır və bunun üçün sizə hesab çıxarılır.

İkiyə endirməməli olduğunuz üç cavab

• unsuspend 409 cavabını verə bilər. Bu o deməkdir ki, saytı siz deyil, bizim sui-istifadə ilə mübarizə komandamız saxlayır. Mesajı göstərin; təkrar cəhd etməyin.
• **Xitam vermək silinməni planlaşdırır, onu dərhal icra etmir.** Tarix pending_deletion_at kimi geri qayıdır. Müştəriyə məlumatlarının hələ silinmədiyi halda artıq silindiyini demək, heç nə deməməkdən daha pisdir.
• disk_used_bytes parametri null ola bilər və null sıfır demək deyil. Bu, heç nəyin istifadə edilmədiyi deyil, ölçə bilmədiyimiz deməkdir. Onu ötürün — öz qeydlərinizə 0 yazmayın, əks halda müştəriyə heç bir məlumat ala bilmədiyiniz bir sayt üçün yaşıl istifadə paneli göstərəcəksiniz.

4. Müştərini daxil edin

POST /v1/reseller/services/{siteId}/sso müştərinizi artıq daxil olmuş şəkildə birbaşa öz hesabına yönləndirən birdəfəlik URL qaytarır.

⛔ Bunu səhifəni göstərdiyiniz zaman deyil, onlar kliklədikdə yaradın. Keçid birdəfəlikdir və bir neçə dəqiqə ərzində etibarlılığını itirir, buna görə də səhifəyə yazılmış keçid ilk səhifə baxışında yanır və sizinlə brauzer arasındakı hər bir keşdə qalır.

5. Əvəzində modul quraşdırın

• WHMCS — modulu modules/servers/zinn/ qovluğuna kopyalayın, Şifrə sahəsi API açarınız olan bir server əlavə edin və məhsul üzərində məhsul xəttini təyin edin. Əlaqəni sınaqdan keçir düyməsini basın: bu, real zəng edir və platformanın nə cavab verdiyini sizə bildirir.
• HostBill — includes/modules/Hosting/zinn/ qovluğuna kopyalayın və eyni şəkildə qoşun.
• WordPress — Zinn® Reseller Toolkit: domen axtarışı, müştərilərinizin hostinqinə daxilolma keçidi və sifariş ödənildikdə WooCommerce təminatı. Açıq mənbəlidir: <https://github.com/Zinn-Digital/zinn-reseller-toolkit>, və ya onu idarəetmə panelinizdəki Qoşmalar bölməsindən endirin.

6. Canlı rejimə keçin

Real sifariş qəbul etməzdən əvvəl bunları yoxlayın:

• Modulda əlaqə testi uğurla keçir və ya ilk curl sorğunuz siyahı qaytarır.
• Qiymət siyahınız təyin edilib (Yenidən satış → Qiymətləriniz).
• Ödəniş şlüzünüz qoşulub (Yenidən satış → Ödəniş şlüzləri) — müştəriləriniz sizə, öz hesabınız vasitəsilə ödəyir.
• Şirkət məlumatlarınız daxil edilib (Yenidən satış → Şirkətiniz), beləliklə müştəri fakturalarınızda bizim deyil, sizin hüquqi şəxsiniz və ƏDV nömrəniz əks olunur.
• Başa çatmış bir real sifariş yerləşdirmisiniz və saytın yarandığını görmüsünüz.

Digər hər şeyin olduğu yer

Tam API sorğu kitabçası — spesifikasiyamız əsasında yaradılmış hər bir son nöqtə, hər birinin ehtiyac duyduğu icazə ilə birlikdə — <https://zinndigital.com/developers/api> ünvanındadır.