Saltar al contenido

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

Autenticación ​

Obligatorio

Incluye uno de estos encabezados en tu solicitud:

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.

CampoTipoDescripción
usedintegerMensajes aceptados hoy
limitinteger | nullMensajes permitidos por día, null en planes ilimitados
unlimitedbooleantrue cuando el plan no tiene límite diario
rejectedintegerSolicitudes rechazadas hoy por haberse alcanzado el límite
resets_atstringPró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 ​

EstadoDescripción
401No 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-*.

Documentación de Pocket Alert