Documentazione API
Crea integrazioni con l'API REST di Buzzley. 49 endpoint in 14 gruppi di risorse.
Autenticazione
Ogni richiesta API deve includere la tua chiave API nell'header Authorization con lo schema Bearer. Puoi creare e gestire le chiavi API dalla pagina Chiavi API.
curl https://api.buzzley.app/api/v1/reminders \
-H "Authorization: Bearer bzl_your_api_key_here"URL di base
Tutti gli endpoint sono relativi a:
https://api.buzzley.app/api/v1Limiti di frequenza
Il tuo account può fare 60 richieste al minuto e 10.000 al giorno, condivise tra tutte le sue chiavi API. Ogni risposta include questi header:
| Header | Descrizione |
|---|---|
| X-RateLimit-Limit | Numero massimo di richieste al minuto |
| X-RateLimit-Remaining | Richieste rimanenti nella finestra attuale |
| X-RateLimit-Reset | Secondi al ripristino del limite |
Quando superi il limite, ricevi una risposta 429 con un campo retry_after.
Formato delle risposte
Tutte le risposte sono in JSON. Le risposte riuscite racchiudono il contenuto in un campo data. Gli errori contengono un oggetto error con un code leggibile dalle macchine e un message leggibile dalle persone.
// Success
{
"data": { ... }
}
// Error
{
"error": {
"code": "INVALID_REQUEST",
"message": "title is required"
}
}Codici di errore
| Stato | Codice | Descrizione |
|---|---|---|
| 400 | INVALID_REQUEST | Il body o i parametri della richiesta non sono validi |
| 401 | UNAUTHORIZED | Chiave API mancante o non valida |
| 403 | FORBIDDEN | La chiave API non ha l'autorizzazione per questa azione |
| 404 | NOT_FOUND | La risorsa richiesta non esiste |
| 409 | CONFLICT | La risorsa esiste già o c'è un conflitto di stato |
| 429 | RATE_LIMITED | Troppe richieste: riprova dopo l'attesa indicata |
| 500 | INTERNAL_ERROR | Si è verificato un errore imprevisto del server |
Riferimento degli endpoint
Ping1 endpoint
Chiavi API1 endpoint
Una chiave API può elencare le chiavi, ma non può crearle, revocarle o eliminare l'account: queste chiamate restituiscono 403 per una chiave API. Crea e revoca le chiavi nella pagina Chiavi API dopo aver fatto l'accesso.
Promemoria7 endpoint
Istanze4 endpoint
Le istanze rappresentano le singole ripetizioni di un promemoria ricorrente.
Categorie4 endpoint
Modelli6 endpoint
Durate di posticipo4 endpoint
Impostazioni2 endpoint
Gruppo8 endpoint
Ogni account appartiene a un gruppo (famiglia, team o personale). I limiti dei dispositivi si applicano a livello di gruppo. Le operazioni riservate al proprietario richiedono che il titolare della chiave API sia il proprietario del gruppo.
Dispositivi2 endpoint
Galleria7 endpoint
La galleria dei modelli permette agli utenti di condividere e installare modelli creati dalla community. I modelli con 3 o più segnalazioni vengono nascosti in automatico in attesa di moderazione.