Autentifikatsiya
API kalitini bearer token sifatida yuboring. Kalit reseller.view ruxsatiga ega boʻlishi shart; ruxsatsiz kalit 404 emas, balki 403 xatosi bilan rad etiladi.
Tashkilotingiz identifikatori kiritiladigan joy
Bu soʻrovnoma oxiri org_id parametrini soʻrov parametri sifatida qabul qiladi. Uni kiritmasangiz, chaqiruv butun ijarachi quyi daraxtingizni qamrab oladi; uni bitta tashkilotga cheklash uchun yuboring.
Tashkilotingiz identifikatori boshqaruv panelingizdagi API kalitlari ekranida, kalitning o'z yonida joylashgan. Bu siz amalga oshiradigan har bir so'rovda bir xil identifikator hisoblanadi.
Sinab ko'rish
Qavslardagi har qanday narsani o'z qiymatlaringiz bilan, kalit pleysxolderini эsa boshqaruv panelingizdagi kalit bilan almashtiring.
curl -X GET https://api.zinndigital.com/v1/reseller/services/{siteId} \
-H "Authorization: Bearer zdk_live_…"Tizimga kirganmisiz? Boshqaruv panelingizdagi API konsoli haqiqiy tashkilot ID raqamingiz va shaxsiy kalitingizni avtomatik to'ldiradi hamda haqiqiy javobni ko'rishingiz uchun so'rovni jonli API orqali bajaradi. Ushbu yakuniy nuqtani API konsolida oching
Tafsilotlar
The same row `listResellerServices` returns, for one site. A site outside your client subtree is a 404, never a 403 — so this is not an existence oracle. Requires `reseller.view`.
Parametrlar
| Nomi | Turi | Majburiy | Nima bu |
|---|---|---|---|
siteId (path) | Uuid | Ha | Site ID (UUIDv7). |
org_id (query) | Uuid | Yo'q | Which of your organizations this applies to. Required only when you belong to more than one here. |
Javob
| Nomi | Turi | Majburiy | Nima bu |
|---|---|---|---|
site_id | Uuid | Ha | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
client_org_id | Uuid | Ha | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
client_org_name | string | Ha | — |
primary_domain | string | Ha | — |
name | string | Yo'q | — |
status | SiteStatus | Ha | A site's lifecycle state (docs/04 §3). A newly created site is `pending` until the provisioning workflow picks it up; `deleted` is terminal. `restricted` and `quarantined` are t… |
product_line | object | Yo'q | — |
plan_code | object | Yo'q | — |
plan_name | object | Yo'q | — |
held_by_reseller | boolean | Yo'q | True when the current suspension was placed through this surface, which is the only case `unsuspendResellerService` will release. A site suspended by the abuse desk reports fals… |
pending_deletion_at | object | Yo'q | When a scheduled deletion falls due, or null. |
sell_amount_minor | object | Yo'q | What YOU charge for this plan, in minor units of `sell_currency` — your own price-list row if you have authored one, otherwise our list price with your default markup applied. N… |
sell_currency | object | Yo'q | — |
created_at | string | Ha | — |
disk_used_bytes | object | Yo'q | Null when the hosting platform has no usage to report for this site. |
bandwidth_used_bytes | object | Yo'q | Outbound bandwidth this billing period, or null. |
usage_measured_at | object | Yo'q | When the reading was taken. Null alongside null usage — so "we have not measured this" is never mistaken for "it used nothing" (§2.44). |
Ushbu yakuniy nuqta qaytarishi mumkin bo'lgan xatolar
401 · 403 · 404 · 429