domains
PUT /v1/domains/{domainId}/settings
Change a domain's registrar settings.
Аутентификация
API кілтін bearer токені ретінде жіберіңіз. Кілтте domains.dns.manage рұқсаты болуы тиіс; онсыз кілтке 404 емес, 403 қатесі қайтарылады.
Бұл соңғы нүкте ұйым идентификаторын қабылдамайды. Сіздің кілтіңіз оның қай ұйымға тиесілі екенін өзі анықтайды және жауап соған шектеледі.
Әрекет етіп көру
Бұрыштық жақшалардағы кез келген нәрсені өз мәндеріңізбен, ал кілт орналастырушысын басқару тақтасынан алынған кілтпен алмастырыңыз.
curl -X PUT https://api.zinndigital.com/v1/domains/{domainId}/settings \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ }'Жүйеге кіргенсіз бе? Бақылау тақтасындағы API консолі ұйымыңыздың нақты идентификаторы мен жеке кілтіңізді автоматты түрде толтырады да, нақты жауапты көре алуыңыз үшін сұрауды тікелей жұмыс істеп тұрған API арқылы орындайды. Бұл соңғы нүктені API консолінде ашыңыз
Мәліметтер
A **partial** update: an omitted field is left alone, never reset. Each changed flag is applied at the **registrar first** and mirrored onto our record only once it succeeds — so this endpoint never reports a protection (a transfer lock, WHOIS privacy) that the registrar has not actually applied. `auto_renew` is ours alone: we drive renewals, so it takes no registrar call. A registrar that refuses the change is a `503`. Requires `domains.dns.manage`.
Параметрлер
| Аты | Tүрі | Міндетті | Мазмұны |
|---|---|---|---|
domainId (path) | Uuid | Иә | The domain's id. |
Сұрау денесі
| Аты | Tүрі | Міндетті | Мазмұны |
|---|---|---|---|
auto_renew | boolean | Жоқ | — |
transfer_lock | boolean | Жоқ | — |
dnssec_enabled | boolean | Жоқ | — |
privacy_enabled | boolean | Жоқ | — |
Жауап
| Аты | Tүрі | Міндетті | Мазмұны |
|---|---|---|---|
registrar | string | Иә | The registrar driver holding this domain (a driver name, never a vendor id). |
auto_renew | boolean | Иә | Whether we renew it before expiry. Ours, not the registrar's. |
transfer_lock | boolean | Иә | Registrar transfer lock (`clientTransferProhibited`) — blocks an outbound transfer. |
dnssec_enabled | boolean | Иә | — |
privacy_enabled | boolean | Иә | WHOIS privacy / registrant redaction, where the TLD supports it. |
Бұл соңғы нүкте қайтара алатын қателер
401 · 403 · 404 · 422 · 429 · 503