Panoramica di riferimento API
L'API REST DiffHook consente di creare e gestire a livello di codice i monitoraggi e di eseguire query sui log di consegna.
URL di base
https://www.diffhook.com
Autenticazione
Tutte le richieste richiedono un token al portatore:
Authorization: Bearer JWTXYZ
Tipo di contenuto
Includere sempre Content-Type: application/json nelle richieste POST e PUT.
Tipi di risorse
Monitor: la risorsa principale. Un monitor rappresenta un URL guardato, insieme alla sua configurazione (intervallo, destinazione, selettore).
Log: record immutabili delle consegne dei webhook. Creato automaticamente quando viene rilevata una modifica.
Timestamp
Tutti i timestamp sono nel formato ISO 8601 in UTC:
2026-03-16T14:22:00Z
Impaginazione
Per impostazione predefinita, gli endpoint dell'elenco restituiscono fino a 50 elementi. Utilizza il parametro di query limit per richiederne fino a 200.
Codici di stato HTTP
| Codice | Significato |
|---|---|
| 200 | Va bene |
| 201 | Creato |
| 204 | Nessun contenuto (eliminazione riuscita) |
| 400 | Richiesta errata: controllare il corpo della richiesta |
| 401 | Non autorizzato: controlla la chiave API |
| 403 | Vietato: limite raggiunto |
| 404 | Non trovato |
| 429 | Tariffa limitata: rallenta |
| 500 | Errore del server: contatta l'assistenza |