visibility
POST /v1/domain-vetting/reports
Vet a domain — spends one report credit.
Аутентификација
Пошаљите API кључ као bearer токен. Ова крајња тачка не наводи конкретну дозволу у спецификацији, па свом кључу доделите најмања неопходна овлашћења и проверите одговор уместо да претпостављате.
Ова крајња тачка не прихвата id организације. Ваш кључ већ идентификује организацију којој припада, а одговор је ограничен на њу.
Испробајте
Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.
curl -X POST https://api.zinndigital.com/v1/domain-vetting/reports \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ "domain": <string> }'Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у API конзоли
Детаљи
Starts a pre-purchase report on domain for the search market location_code (default 2840, the United States). One report credit is taken when the report is created and the report is built in the background (poll GET /v1/domain-vetting/reports/{report_id}). A report where nothing could be read, or one the account's standing no longer allows by the time it runs, gives its credit back. Asking again about the same domain and market inside reuse_days returns the existing report with 200 and costs nothing. Refused with 403 when the organisation holds no credit or is not in good standing, 422 for something that is not a domain or a market we read, and 503 when reports cannot be started right now — in every refusal no credit is taken.
Тело захтева
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
domain | string | Да | A domain name; a pasted URL is reduced to its host. |
location_code | integer | Не | The search market the organic parts are read for (see markets). |
Одговор
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
report | DomainVetSummary | Да | — |
created | boolean | Да | — |
Грешке које ова крајња тачка може вратити
400 · 401 · 403 · 404 · 422 · 503