Uso de mensajes GET
Consulta el uso de mensajes de hoy frente al límite diario de tu plan.
Endpoint
GET https://api.pocketalert.app/v1/messages/usageAutenticación
Obligatorio
Incluye uno de estos encabezados en tu solicitud:
Token: <your-api-key>— Obtenla en Claves de APIAuthorization: Bearer <jwt-token>— Desde Iniciar sesión
Solicitud
Ejemplo de solicitud
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();Respuesta
Respuesta exitosa
200 OK
Devuelve el uso de hoy. El día se calcula en UTC.
| Campo | Tipo | Descripción |
|---|---|---|
used | integer | Mensajes aceptados hoy |
limit | integer | null | Mensajes permitidos por día, null en planes ilimitados |
unlimited | boolean | true cuando el plan no tiene límite diario |
rejected | integer | Solicitudes rechazadas hoy por haberse alcanzado el límite |
resets_at | string | Próximo reinicio, 00:00 UTC, en RFC3339 |
json
{
"used": 42,
"limit": 50,
"unlimited": false,
"rejected": 0,
"resets_at": "2026-09-22T00:00:00Z"
}En un plan ilimitado:
json
{
"used": 1280,
"limit": null,
"unlimited": true,
"rejected": 0,
"resets_at": "2026-09-22T00:00:00Z"
}Respuestas de error
| Estado | Descripción |
|---|---|
401 | No autorizado — token inválido o ausente |
Caso de uso
Comprueba used frente a limit antes de enviar una ráfaga de alertas, o muestra la cuota restante en tu propio panel. Los mismos valores llegan en cada respuesta de Crear mensaje como encabezados X-PA-Daily-*.