Zum Inhalt springen

Nachrichtennutzung GET ​

Ermittle die heutige Nachrichtennutzung im Verhältnis zum Tageslimit deines Tarifs.

Endpunkt ​

GET https://api.pocketalert.app/v1/messages/usage

Authentifizierung ​

Erforderlich

Füge einen dieser Header in deine Anfrage ein:

Anfrage ​

Beispielanfrage ​

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();

Antwort ​

Erfolgreiche Antwort ​

200 OK

Gibt die heutige Nutzung zurück. Der Tag entspricht dem UTC-Tag.

FeldTypBeschreibung
usedintegerHeute angenommene Nachrichten
limitinteger | nullErlaubte Nachrichten pro Tag, null bei Tarifen ohne Limit
unlimitedbooleantrue, wenn der Tarif kein Tageslimit hat
rejectedintegerHeute abgelehnte Anfragen, weil das Limit erreicht war
resets_atstringNächster Reset, 00:00 UTC, im RFC3339-Format
json
{
  "used": 42,
  "limit": 50,
  "unlimited": false,
  "rejected": 0,
  "resets_at": "2026-09-22T00:00:00Z"
}

Bei einem Tarif ohne Limit:

json
{
  "used": 1280,
  "limit": null,
  "unlimited": true,
  "rejected": 0,
  "resets_at": "2026-09-22T00:00:00Z"
}

Fehlerantworten ​

StatusBeschreibung
401Nicht autorisiert — Token ungültig oder fehlt

Anwendungsfall

Prüfe used gegen limit, bevor du eine Welle an Push-Benachrichtigungen verschickst, oder zeige die verbleibende Quote in deinem eigenen Dashboard an. Dieselben Werte kommen bei jeder Antwort von Nachricht erstellen als X-PA-Daily-*-Header zurück.

Pocket Alert Dokumentation