Utilizzo messaggi GET
Ottieni l'utilizzo dei messaggi di oggi rispetto al limite giornaliero del tuo piano.
Endpoint
GET https://api.pocketalert.app/v1/messages/usageAutenticazione
Obbligatoria
Includi una di queste intestazioni nella tua richiesta:
Token: <your-api-key>— Ottienila da Chiavi APIAuthorization: Bearer <jwt-token>— Da Accedi
Richiesta
Esempio di richiesta
bash
curl -X GET "https://api.pocketalert.app/v1/messages/usage" \
-H "Token: your-api-key"javascript
const response = await fetch('https://api.pocketalert.app/v1/messages/usage', {
headers: { 'Token': 'your-api-key' }
});
const usage = await response.json();python
import requests
response = requests.get(
'https://api.pocketalert.app/v1/messages/usage',
headers={'Token': 'your-api-key'}
)
print(response.json())php
$response = Http::withHeaders([
'Token' => 'your-api-key',
])->get('https://api.pocketalert.app/v1/messages/usage');
return $response->json();Risposta
Risposta di successo
200 OK
Restituisce l'utilizzo di oggi. Il giorno è quello UTC.
| Campo | Tipo | Descrizione |
|---|---|---|
used | integer | Messaggi accettati oggi |
limit | integer | null | Messaggi consentiti al giorno, null sui piani illimitati |
unlimited | boolean | true quando il piano non ha un limite giornaliero |
rejected | integer | Richieste rifiutate oggi perché il limite è stato raggiunto |
resets_at | string | Prossimo reset, alle 00:00 UTC, in RFC3339 |
json
{
"used": 42,
"limit": 50,
"unlimited": false,
"rejected": 0,
"resets_at": "2026-09-22T00:00:00Z"
}Su un piano illimitato:
json
{
"used": 1280,
"limit": null,
"unlimited": true,
"rejected": 0,
"resets_at": "2026-09-22T00:00:00Z"
}Risposte di errore
| Stato | Descrizione |
|---|---|
401 | Non autorizzato — Token non valido o mancante |
Caso d’uso
Controlla used rispetto a limit prima di una raffica di avvisi, oppure mostra la quota rimanente nella tua dashboard. Gli stessi valori vengono restituiti in ogni risposta di Crea messaggio sotto forma di intestazioni X-PA-Daily-*.