POST `/v1/ai/site-agent/sites/{site_id}/check`

Read this site's server, diagnose it, and fix what the customer allows.

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

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

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

Փորձել

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

curl -X POST https://api.zinndigital.com/v1/ai/site-agent/sites/{site_id}/check \
  -H "Authorization: Bearer zdk_live_…"

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

Մանրամասներ

Reads the site's live server — error log, PHP faults, slow queries, disk and memory — diagnoses what is wrong, and applies the fixes this customer has allowed to run unattended. Fixes they have asked to be asked about come back in `offered` with the finding that triggered them, so the screen can show the button. Log text is **redacted before it leaves the server**: visitor IP addresses, email addresses, tokens, keys and passwords are masked, and `logs.sources[].masked` reports how many runs of each kind were removed. On our own fleet the server-wide error log is filtered to this account on the host, so another tenant's lines are never transferred at all. A source that could not be read is returned with `state: unavailable` and a reason, **never omitted** — "we found nothing wrong" and "we could not look" are different answers and only one of them is reassuring. `incomplete` is true whenever any source is in that state. Counts against the monthly allowance. A `402` means the allowance is exhausted or the account is not in good standing; the body carries the allowance and a message. Requires `sites.view`.

Պարամետրեր

Անուն	Տեսակ	Պահանջվում է	Ինչ է դա
`site_id (path)`	`Uuid`	Այո	—

Պատասխան

Անուն	Տեսակ	Պահանջվում է	Ինչ է դա
`site_id`	`Uuid`	Այո	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`source`	`string<ticket, self_serve, staff>`	Այո	—
`incomplete`	`boolean`	Այո	True when any source could not be read or the diagnosis was partial.
`refused`	`boolean`	Այո	—
`refusal_code`	`string`	Ոչ	`allowance_exhausted` or `not_in_good_standing`.
`refusal_message`	`string`	Ոչ	—
`logs`	`AiSiteAgentLogs`	Այո	—
`findings`	`AiSiteAgentFinding[]`	Այո	—
`applied`	`object[]`	Այո	Fixes the AI applied, and under which mode.
`offered`	`object[]`	Այո	Fixes found but NOT applied, with why. `awaiting_your_approval` means the customer asked to be asked; anything else names a refusal.
`allowance`	`AiSiteAgentAllowance`	Ոչ	—

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

401 · 402 · 403 · 404 · 422 · 429

POST /v1/ai/site-agent/sites/{site_id}/check