reseller
PUT /v1/reseller/nameservers
Claim a domain for your own nameservers.
Санҷиши ҳаққоният
Kaliti API-ро ҳамчун рамзи доранда (bearer token) фиристед. Калит бояд дорои иҷозати reseller.manage бошад; калиди бидуни он бо хатои 403 рад карда мешавад, на 404.
Ҷое, ки рақами мушаххаси ташкилоти шумо ҷойгир аст
Ин нуқтаи поёнӣ org_id-ро ҳамчун параметри дархостӣ қабул мекунад. Онро хориҷ кунед ва даъват тамоми зердарахти иҷораи шуморо фаро мегирад; барои маҳдуд кардани даъват ба як созмон онро фиристед.
Rakami муайянкунандаи ташкилоти шумо дар экрани калидҳои API дар панели идоракунии шумо, дар паҳлӯи худи калид ҷойгир аст. Ин як раками муайянкунанда дар ҳар یک дархосте, ки шумо иҷро мекунед, якхела аст.
Санҷидан
Ҳар чизро дар қаavски кунҷӣ бо қиматҳои худ ва ҷойи нигоҳдорандаи калидро бо калима аз панели идоракунии худ иваз кунед.
curl -X PUT https://api.zinndigital.com/v1/reseller/nameservers \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ "domain": <string> }'Воarid шудаед? Консоли API дар панели идоракунии шумо рақами мушаххаси ташкилоти воқеӣ ва калиди худро пур мекунад ва дархостро бар зидди API-и фаъол иҷро мекунад, то шумо посухи воқеиро бубинед. Ин нуқтаи ниҳоиро дар консоли API кушоед
Тафсилот
From acme-hosting.com we build ns1.acme-hosting.com and ns2.acme-hosting.com, served from Zinn Digital®'s own anycast DNS estate. Requires reseller.manage and white-label on your plan. ⛔ Claiming serves nothing yet. The glue records live in your domain, at your registrar, so only you can create them — publish the A records this returns, then call /verify. Until that measurement passes, your clients' zones keep the platform nameservers, because delegating a live domain to a nameserver that does not answer takes that domain off the internet. A domain Zinn® already operates is refused with 422; a domain another reseller already holds ⇒ 409.
Параметрҳо
| Ном | Намуд | Талаб карда мешавад | Ин чӣ аст |
|---|---|---|---|
org_id (query) | Uuid | Не | The organization this call acts on. Optional for a caller with exactly one direct membership; required for anyone with more than one — which is every reseller and every agency… |
Ҷисми дархост
| Ном | Намуд | Талаб карда мешавад | Ин чӣ аст |
|---|---|---|---|
domain | string | Бале | Just the domain you own — acme-hosting.com, with no scheme and no ns1. prefix. We add ns1 and ns2. A domain Zinn® operates is refused. |
Ҷавоб
| Ном | Намуд | Талаб карда мешавад | Ин чӣ аст |
|---|---|---|---|
domain | string | Бале | The reseller's own domain, or "" when they have not claimed one. |
hostnames | string[] | Бале | Derived from domain — ns1.acme-hosting.com, ns2.acme-hosting.com. Two, because registries reject a single-nameserver delegation. |
glue | ResellerNameserverGlue[] | Бале | The A records the reseller must register at THEIR registrar. Nothing we hold can create them: they are a registry operation on a domain we do not sponsor. |
serving | boolean | Бале | — |
status | string | Бале | One sentence from the last check, for the screen and for support. |
vendor | string | Бале | Which of our anycast DNS providers serves these hostnames. |
checked_at | string | Не | When it was last CHECKED, whatever the outcome. null means nobody has looked — a different fact from "checked and not serving". |
checked | boolean | Не | Verify responses only. false means our resolver could not answer and nothing was changed — not that the glue is missing. The two send a reseller to opposite actions. |
supported_vendors | string[] | Не | The anycast providers that can serve a nameserver brand of your own. |
Хатоҳое, ки ин нуқтаи ниҳоӣ метавонад баргардонад
401 · 403 · 409 · 422 · 429