connections

POST `/v1/registrar-accounts/{connectionId}/refresh`

Re-read one linked registrar account now.

Նույնականացում

Ուղարկեք API բանալին որպես bearer token: Բանալին պետք է ունենա connections.manage թույլտվությունը. առանց դրա բանալին մերժվում է 403, և ոչ թե 404 կարգավիճակով:

Այս վերջնակետը կազմակերպության ID չի ընդունում: Ձեր բանալին արդեն իսկ նույնականացնում է այն կազմակերպությունը, որին պատկանում է, և պատասխանը սահմանափակված է դրանով:

Փորձել

Փոխարինեք անկյունային փակագծերում գտնվող ցանկացած բան ձեր սեփական արժեքներով, և բանալու տեղապահը՝ ձեր վահանակի բանալիով:

curl -X POST https://api.zinndigital.com/v1/registrar-accounts/{connectionId}/refresh \
  -H "Authorization: Bearer zdk_live_…"

Մուտք գործե՞լ եք: Ձեր վահանակի API վահանակը լրացնում է ձեր իրական կազմակերպության ID-ն և ձեր սեփական բանալին և գործարկում է հարցումը ուղիղ API-ի դեմ, որպեսզի կարողանաք տեսնել փաստացի պատասխանը: Բացեք այս վերջնակետը API վահանակում

Մանրամասներ

Asks the registrar for the account's current domain list and reconciles it: new domains appear, changed ones are updated, and domains the account no longer lists are retired. ⛔ retired is reported rather than swallowed. A refresh that retires forty domains is either a transfer the customer made or a key that has lost access, and both need saying out loud. ⛔ A registrar that refuses answers 200 with refused set, not a 5xx. The customer's own key or their registrar declined — that is an answer they can act on, and an error status makes the client render an anonymous failure where a specific, fixable sentence belongs. When refused is set every count is 0 and nothing was retired: a vendor outage is not a portfolio change. Spends the customer's own vendor quota, so it requires connections.manage.

Պարամետրեր

Անուն	Տեսակ	Պահանջվում է	Ինչ է դա
`connectionId (path)`	`Uuid`	Այո	The MCP connection's id.

Պատասխան

Անուն	Տեսակ	Պահանջվում է	Ինչ է դա
`refused`	`string`	Այո	Empty on success. Otherwise a machine reason (`listing_failed`, `no_driver`) — and when it is set, every count below is 0 and nothing was retired, because a failure to read is…
`vendor`	`string`	Այո	—
`seen`	`integer`	Այո	Domains the registrar listed.
`created`	`integer`	Այո	—
`updated`	`integer`	Այո	—
`retired`	`integer`	Այո	Domains the account stopped listing, marked gone rather than deleted. ⛔ Shown to the customer, never swallowed: it is either a transfer they made or a key that lost access.

Այս վերջնակետի կողմից վերադարձվող սխալները

401 · 403 · 404 · 422 · 429

POST /v1/registrar-accounts/{connectionId}/refresh