POST /v1/visibility/targets/{targetId}/run

Аутентификација

Пошаљите API кључ као bearer токен. Ова крајња тачка не наводи конкретну дозволу у спецификацији, па свом кључу доделите најмања неопходна овлашћења и проверите одговор уместо да претпостављате.

Ова крајња тачка не прихвата id организације. Ваш кључ већ идентификује организацију којој припада, а одговор је ограничен на њу.

Испробајте

Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.

curl -X POST https://api.zinndigital.com/v1/visibility/targets/{targetId}/run \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "kind": <VisibilityAuditKind> }'

Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у API конзоли

Детаљи

Starts an on-demand audit and returns 202 with a workflow id. The scheduled audit is included in the add-on; an on-demand run spends Zinn® credits, and the request is refused with 403 when the balance will not cover it. This is asynchronous by necessity, not by preference: one AI-visibility audit is a dozen provider calls and some answer engines take minutes. Poll the audit list for the result. The workflow id is deterministic per target and product, so pressing the button twice while a run is in flight costs one audit rather than two. A run after a finished one always starts. Rank tracking, product data and reputation measure only what the customer has supplied, so they are refused with 422 — before anything is spent — until the target has at least one search phrase, product or confirmed review profile respectively. A run a metered SEO allowance pays for — a site audit, a backlink refresh, a keyword list, a domain report, or a link-watch check — spends that allowance and no credit; once the month's allowance is used it is refused with 422 naming the allowance and the day it resets (see VisibilityPlan.allowances).

Параметри

Тело захтева

Одговор

Грешке које ова крајња тачка може вратити

401 · 403 · 404 · 422 · 503