public
POST /v1/public/status/subscribe
Ask for email updates from the public status page.
Autenticazione
Questo endpoint è pubblico. Non richiede credenziali né alcuna organizzazione: è ciò che leggono il nostro sito di marketing e i nostri motori di risposta basati su IA.
Questo endpoint non richiede alcun ID organizzazione. La tua chiave identifica già l'organizzazione a cui appartiene e la risposta è limitata ad essa.
Provalo
Sostituisci qualsiasi elemento tra parentesi angolari con i tuoi valori e il segnaposto key con una chiave dalla tua dashboard.
curl -X POST https://api.zinndigital.com/v1/public/status/subscribe \
-H "Content-Type: application/json" \
-d '{ }'Hai effettuato l'accesso? La console API nella tua dashboard inserisce il tuo ID organizzazione reale e la tua chiave personale, ed esegue la richiesta sull'API live in modo da poter vedere la risposta effettiva. Apri questo endpoint nella console API
Dettagli
docs/121. Unauthenticated — a prospect subscribing has no account. ⛔ **Double opt-in.** The address receives exactly one thing until it confirms: its own confirmation link. Anyone can type anyone's address into a public form, and single opt-in would make this endpoint a way to mail strangers from our domain. ⛔ The response is identical whether or not the address is already known. Confirming that a given address is on the list would be an enumeration oracle, and this list contains prospects and journalists. Rate limited per client.
Corpo della richiesta
| Nome | Tipo | Obbligatorio | Che cos'è |
|---|---|---|---|
kind | string<email, webhook> | No | ⚖️ Owner, 2026-09-03 - *"on the status page can you set up webhook for updates for it"*. `webhook` requires `endpoint`; `email` requires `email`. |
email | string | No | — |
endpoint | string | No | An `https://` endpoint that will receive one signed JSON POST per incident update. ⛔ `https` only - the signature proves ORIGIN, not confidentiality, so a plain `http` endpoint… |
locale | string | No | Which language to send in. Falls back to English for an unknown code rather than refusing — a wrong language is a worse reason to reject a subscription than no language at all. |
Risposta
| Nome | Tipo | Obbligatorio | Che cos'è |
|---|---|---|---|
detail | string | Sì | — |
Errori che questo endpoint può restituire
422 · 429