billing

GET `/v1/sla/periods`

Recent months for every monitored site, and what may be claimed.

Autentizace

Odešlete klíč API jako bearer token. Tento koncový bod ve specifikaci uvádí specifické oprávnění, takže svému klíči udělte to nejmenší možné a místo předpokladů zkontrolujte odpověď.

Sem patří ID vaší organizace

Tento koncový bod přijímá org_id jako parametr dotazu. Pokud ho vynecháte, volání pokryje celý podstrom vašeho nájemce; jeho odesláním volání zúžíte na jednu organizaci.

ID vaší organizace najdete na obrazovce API klíčů ve vašem přehledu, hned vedle samotného klíče. Je to stále stejné ID v každém volání, které provedete.

Vyzvednout

Nahraďte cokoli v závorkách vlastními hodnotami a zástupný symbol klíče klíčem z vašeho řídicího panelu.

curl -X GET https://api.zinndigital.com/v1/sla/periods \
  -H "Authorization: Bearer zdk_live_…"

Přihlášeni? Konzole API ve vašem dashboardu automaticky doplní vaše skutečné ID organizace i váš vlastní klíč a odešle požadavek na živé API, abyste viděli reálnou odpověď. Otevřete tento koncový bod v konzoli API

Podrobnosti

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`.

Parametry

Název	Typ	Požadováno	Co to je
`org_id (query)`	`string`	Ne	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…

Odpověď

Název	Typ	Požadováno	Co to je
`policy`	`SlaPolicy`	Ano	—
`periods`	`SlaPeriod[]`	Ano	—

Chyby, které může tento koncový bod vrátit

401 · 403