ai
GET /v1/ai/site-agent/preferences
What this customer lets the AI do to their sites without asking.
Упълномощаване
Изпратете API ключ като токен за носене. Ключът трябва да притежава разрешението sites.view; ключ без него се отхвърля с 403, а не с 404.
Където отива идентификаторът на вашата организация
Този ендпойнт приема org_id като параметър на заявката. Оставете го празен и извикването ще обхване цялото ви поддървано дърво; изпратете го, за да ограничите извикването до една организация.
ИД на вашата организация се намира на екрана с API ключове във вашето табло за управление, до самия ключ. Това е същият ИД във всяко заявка, която правите.
Опитайте
Заменете всичко в квадратни скоби със собствени стойности, а ключовия заместващ символ – с ключ от вашето табло за управление.
curl -X GET https://api.zinndigital.com/v1/ai/site-agent/preferences \
-H "Authorization: Bearer zdk_live_…"Влязохте ли в профила си? API конзолата във вашето табло за управление попълва действителното идентификационно число на вашата организация и вашия собствен ключ и изпълнява заявката спрямо реалното API, за да можете да видите действителния отговор. Отворете този крайpoint в API конзолата
Детайли
One row per fix the AI knows how to apply, carrying three values and not one: what the customer asked for (requested), what will actually happen (effective), and the highest mode the platform currently permits (ceiling). They differ when a customer has chosen more autonomy than a fix has earned. A response carrying only effective would misreport the customer's own setting back to them — they chose "just fix it", the page shows "ask me first", and it looks as though their click did not register. clamped is true in exactly that case and reason says why in words a customer can read. The ceiling is the platform's, not the customer's: a brand-new fix nobody has watched work cannot be set to unattended by anybody. Requires sites.view.
Параметри
| Име | Тип | Задължително | Какво представлява |
|---|---|---|---|
org_id (query) | Uuid | Не | Which organization this is about. Required when the caller belongs to more than one; a caller in exactly one may omit it. |
Отговор
| Име | Тип | Задължително | Какво представлява |
|---|---|---|---|
preferences | AiSiteAgentPreference[] | Да | — |
modes | object[] | Да | The available modes in increasing order of autonomy. |
Грешки, които този крайpoint може да върне
401 · 403 · 422 · 429