본문으로 건너뛰기

메시지 사용량 GET ​

오늘의 메시지 사용량을 플랜의 일일 한도와 비교해 확인하세요.

엔드포인트 ​

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

인증 ​

필수

요청에 다음 헤더 중 하나를 포함하세요:

  • Token: <your-api-key> — API 키에서 발급받을 수 있습니다
  • Authorization: Bearer <jwt-token> — 로그인에서 발급

요청 ​

요청 예시 ​

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

응답 ​

성공 응답 ​

200 OK

오늘의 사용량을 반환합니다. 하루의 기준은 UTC 날짜입니다.

필드타입설명
usedinteger오늘 접수된 메시지 수
limitinteger | null하루에 허용된 메시지 수. 무제한 플랜에서는 null
unlimitedboolean플랜에 일일 한도가 없으면 true
rejectedinteger한도에 도달해 오늘 거부된 요청 수
resets_atstring다음 초기화 시각(00:00 UTC, RFC3339 형식)
json
{
  "used": 42,
  "limit": 50,
  "unlimited": false,
  "rejected": 0,
  "resets_at": "2026-09-22T00:00:00Z"
}

무제한 플랜인 경우:

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

오류 응답 ​

상태설명
401인증 실패 — 토큰이 잘못되었거나 없음

사용 사례

대량의 알림을 보내기 전에 used를 limit과 비교하거나, 자체 대시보드에 남은 할당량을 표시하세요. 같은 값은 모든 메시지 생성 응답에 X-PA-Daily-* 헤더로도 포함됩니다.

Pocket Alert 문서