Vai al contenuto

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/usage

Autenticazione ​

Obbligatoria

Includi una di queste intestazioni nella tua richiesta:

  • Token: <your-api-key> — Ottienila da Chiavi API
  • Authorization: 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.

CampoTipoDescrizione
usedintegerMessaggi accettati oggi
limitinteger | nullMessaggi consentiti al giorno, null sui piani illimitati
unlimitedbooleantrue quando il piano non ha un limite giornaliero
rejectedintegerRichieste rifiutate oggi perché il limite è stato raggiunto
resets_atstringProssimo 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 ​

StatoDescrizione
401Non 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-*.

Documentazione di Pocket Alert