billing
GET /v1/sla/periods
Recent months for every monitored site, and what may be claimed.
Автентифікація
Надішліть ключ API як маркер носія (bearer token). Ця кінцева точка не вказує конкретного дозволу в специфікації, тому надайте своєму ключу мінімально необхідні права та перевірте відповідь, замість того щоб припускати.
Де вказується ідентифікатор вашої організації
Цей ендпоїнт приймає org_id як параметр запиту. Залиште його порожнім, і виклик охопить увесь ваше дерево орендарів; надішліть його, щоб звузити виклик до однієї організації.
Ідентифікатор вашої організації знаходиться на екрані API-ключів у вашій панелі керування, поруч із самим ключем. Це той самий ідентифікатор у кожному вашому запиті.
Спробувати
Замініть усе в кутових дужках власними значеннями, а заповнювач ключа — ключем із вашої панелі керування.
curl -X GET https://api.zinndigital.com/v1/sla/periods \
-H "Authorization: Bearer zdk_live_…"Увійшли в систему? Консоль API у вашій панелі керування автоматично підставляє ваш реальний ідентифікатор організації та ваш власний ключ, а також виконує запит до робочого API, щоб ви могли побачити справжню відповідь. Відкрийте цю кінцеву точку в консолі API
Деталі
One row per monitored site per calendar month, over the last six months. Only monitors attached to a site we **host** appear: we do not promise uptime for a URL we do not serve, and watching URLs we do not serve is the uptime product's whole purpose. ⛔⛔ `verdict` has **three** values and they must not be folded into a boolean — `met`, `missed`, and `unadjudicable` when our own coverage was too thin to decide. Reading `unadjudicable` as `met` is the convenient fold and it is the one that saves us money, so it is refused here (§2.44). `uptime_percent` is **null** when no check was made: zero checks is not zero uptime. Gated on `billing.view`.
Параметри
| Назва | Тип | Обов'язкове | Що це таке |
|---|---|---|---|
org_id (query) | string | Ні | Narrow to one organisation in the caller's subtree — what the dashboard's org switcher sends. ⛔ **Narrow only:** intersected with what the caller may already read, so an org out… |
Відповідь
| Назва | Тип | Обов'язкове | Що це таке |
|---|---|---|---|
policy | SlaPolicy | Так | — |
periods | SlaPeriod[] | Так | — |
Помилки, які може повертати ця кінцева точка
401 · 403