Nachrichtennutzung GET
Ermittle die heutige Nachrichtennutzung im Verhältnis zum Tageslimit deines Tarifs.
Endpunkt
GET https://api.pocketalert.app/v1/messages/usageAuthentifizierung
Erforderlich
Füge einen dieser Header in deine Anfrage ein:
Token: <your-api-key>— Hol ihn dir unter API-SchlüsselAuthorization: Bearer <jwt-token>— Von Anmelden
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.
| Feld | Typ | Beschreibung |
|---|---|---|
used | integer | Heute angenommene Nachrichten |
limit | integer | null | Erlaubte Nachrichten pro Tag, null bei Tarifen ohne Limit |
unlimited | boolean | true, wenn der Tarif kein Tageslimit hat |
rejected | integer | Heute abgelehnte Anfragen, weil das Limit erreicht war |
resets_at | string | Nä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
| Status | Beschreibung |
|---|---|
401 | Nicht 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.