Menjual pengehosan Zinn® daripada sistem anda sendiri

Anda menjual semula pengehosan kami. Klien anda adalah milik anda: harga anda, invois anda, pembekal pembayaran anda. Beginilah cara anda mengendalikan platform kami daripada apa sahaja yang anda sudah jalankan — panel pengebilan, tapak WordPress anda sendiri, atau skrip.

Apa yang benar-benar dilihat oleh klien anda

Sebelum mekaniknya: klien anda tidak perlu melihat kami. Tiga antara muka, dan anda memilih yang mana satu mahu digunakan.

| Antara muka | Milik siapa | |---|---| | Panel pengehosan, pada nama hos anda sendiri | Tetapkan nama hos panel di bawah Penjualan Semula → Jenama anda dan klien anda log masuk di panel.yourcompany.com dengan logo anda dan warna anda. Panel yang sama, alamat anda. | | Tapak web anda sendiri | Palam gerak (plugin) WordPress meletakkan carian domain dan pautan log masuk satu klik pada tapak anda, dan menerima pesanan melalui pembayaran WooCommerce anda sendiri. | | Panel pengebilan anda | WHMCS atau HostBill kekal sebagai pintu depan; modul memperuntukkan di belakangnya dan butang kawasan klien melog masuk mereka terus ke pengehosan mereka. |

⛔ Mana-mana yang anda pilih, anda adalah pedagang rekod untuk klien anda: harga anda, invois anda, nombor VAT anda, pembekal pembayaran anda. Kami mengenakan bayaran kepada anda, sebulan sekali, pada kadar borong.

Sebaik sahaja anda telah menetapkan nama hos panel, letakkannya di dalam medan Alamat panel pada palam gerak (plugin) WordPress dan tiada tempat lain — pautan log masuk yang dijana oleh API ini mengikutinya secara automatik.

Empat cara masuk

Terdapat empat cara masuk, dan kesemuanya melakukan perkara yang sama di bahagian belakang:

| | Untuk | |---|---| | Modul WHMCS | Kedai WHMCS | | Modul HostBill | Kedai HostBill | | Palam gerak (plugin) WordPress | Menjual dari tapak WordPress atau WooCommerce anda sendiri | | API | Apa-apa sahaja — Blesta, sistem dalaman, skrip cron |

1. Dapatkan kunci API

Dalam papan pemuka anda, pergi ke Kunci API dan buat satu. Berikan hanya apa yang diperlukannya:

| Kebenaran | Mengapa | |---|---| | org.read | Baca akaun klien anda | | sites.create | Peruntukkan tapak | | sites.view | Baca perkhidmatan | | sites.delete | Tamatkan | | reseller.view | Senaraikan perkhidmatan anda dan baca penggunaan | | reseller.provision | Tangguhkan, lepaskan, dan log masuk klien |

⛔ Jangan berikan integrasi reseller.manage. Kebenaran itu mengedit senarai harga anda dan kelayakan gerbang pembayaran anda sendiri. reseller.provision wujud khusus supaya kunci yang anda tampal ke dalam panel pengebilan atau tapak web tidak memerlukannya.

Kunci itu ditunjukkan sekali. Simpannya di tempat anda menyimpan kelayakan anda yang lain — jangan sekali-kali dalam fail yang disajikan oleh pelayan web anda.

2. Buat panggilan pertama anda

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

Itu mengembalikan setiap perkhidmatan yang telah anda peruntukkan, satu baris setiap tapak, dengan klien kepunyaannya, statusnya, dan apa yang anda caj untuknya. Pada akaun baharu, ia adalah senarai kosong — iaitu jawapan yang betul, bukannya ralat.

3. Keseluruhan integrasi, dalam enam panggilan

BILA                 PANGGILAN
pesanan dibayar      POST   /v1/orgs                                   sekali setiap PELANGGAN
                     POST   /v1/sites                                  sekali setiap PERKHIDMATAN
mereka belum bayar   POST   /v1/reseller/services/{siteId}/suspend
mereka bayar         POST   /v1/reseller/services/{siteId}/unsuspend
mereka membatalkan   DELETE /v1/sites/{siteId}
"log masuk ke hosting" POST   /v1/reseller/services/{siteId}/sso

Peruntukan adalah dua panggilan, dan kunci adalah penting:

# 1. akaun pelanggan — dikunci pada id pelanggan ANDA
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. tapak mereka — dikunci pada id perkhidmatan ANDA
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"}'

Dua peraturan yang merugikan wang apabila anda tersilap

Kunci akaun pada PELANGGAN anda dan tapak pada PERKHIDMATAN anda. Pesanan kedua pelanggan mesti masuk ke akaun yang telah mereka miliki. Kunci kedua-duanya pada perkhidmatan dan seorang pelanggan akhirnya mempunyai tiga akaun yang tidak berkaitan dan tiga panel yang berasingan.
Hantar Idempotency-Key pada setiap POST, dibina daripada id anda sendiri untuk perkara tersebut. Setiap sistem pengebilan mencuba semula — a, panggilan balik gerbang tiba dua kali, seorang admin menjalankan semula peruntukan yang gagal, seorang pelanggan dwi-klik. Tanpa kunci, percubaan kedua akan mencipta tapak kedua dan anda akan dicaj untuknya.

Tiga jawapan yang anda tidak boleh ratakan menjadi dua

unsuspend boleh menjawab 409. Ini bermakna pasukan penyalahgunaan kami sedang memegang tapak tersebut, bukannya anda. Paparkan mesej; jangan mencubanya semula.
**Menamatkan menjadualkan pemadaman, ia tidak melakukannya.** Tarikh kembali sebagai pending_deletion_at. Memberitahu pelanggan bahawa data mereka sudah tiada apabila ia sebenarnya tidak hilang adalah lebih teruk daripada tidak memberitahu mereka apa-apa.
disk_used_bytes boleh menjadi null, dan null bukan sifar. Ini bermakna kami tidak dapat mengukur, bukannya tiada apa-apa yang digunakan. Langkau ia — jangan tulis 0 ke dalam rekod anda sendiri, atau anda akan memaparkan bar penggunaan hijau kepada pelanggan untuk tapak yang anda tiada bacaan mengenainya.

4. Log masuk klien

POST /v1/reseller/services/{siteId}/sso mengembalikan URL guna tunggal yang membawa klien anda terus ke akaun mereka sendiri, yang sudah dilog masuk.

⛔ Jana ia apabila mereka klik, jangan sekali-kali apabila anda memaparkan halaman. Pautan itu adalah guna tunggal dan tamat tempoh dalam masa beberapa minit, jadi pautan yang ditulis ke dalam halaman akan terbakar pada paparan halaman pertama dan ditinggalkan dalam setiap cache antara anda dan pelayar.

5. Pasang modul sebaliknya

WHMCS — salin modul ke modules/servers/zinn/, tambah pelayan yang Kata laluannya adalah kunci API anda, dan tetapkan baris produk pada produk. Tekan Uji Sambungan: ia membuat panggilan sebenar dan memberitahu anda apa yang dikatakan oleh platform.
HostBill — salin ke includes/modules/Hosting/zinn/ dan sambungkannya dengan cara yang sama.
WordPress — Toolkit Penjual Semula Zinn®: carian domain, pautan log masuk ke pengehosan klien anda, dan peruntukan WooCommerce apabila pesanan dibayar. Sumber terbuka di <https://github.com/Zinn-Digital/zinn-reseller-toolkit>, atau muat turun dari Palam Gerak (Plugins) dalam papan pemuka anda.

6. Mula siar (Go live)

Semak perkara ini sebelum anda mengambil pesanan sebenar:

Ujian sambungan lulus pada modul, atau curl pertama anda mengembalikan senarai.
Senarai harga anda ditetapkan (Penjualan Semula → Harga anda).
Gerbang pembayaran anda disambungkan (Penjualan Semula → Gerbang pembayaran) — klien anda membayar anda, melalui akaun anda sendiri.
Butiran syarikat anda dimasukkan (Penjualan Semula → Syarikat anda) supaya invois klien anda membawa entiti undang-undang dan nombor VAT anda, bukannya kami.
Anda telah membuat satu pesanan sebenar dari awal hingga akhir dan melihat tapak itu muncul.

Di mana terletaknya yang lain

Rujukan API lengkap — setiap titik akhir, dijana daripada spesifikasi kami, dengan kebenaran yang diperlukan oleh setiap satu — berada di <https://zinndigital.com/developers/api>.