메시지 사용량 GET
오늘의 메시지 사용량을 플랜의 일일 한도와 비교해 확인하세요.
엔드포인트
GET https://api.pocketalert.app/v1/messages/usage인증
필수
요청에 다음 헤더 중 하나를 포함하세요:
요청
요청 예시
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 날짜입니다.
| 필드 | 타입 | 설명 |
|---|---|---|
used | integer | 오늘 접수된 메시지 수 |
limit | integer | null | 하루에 허용된 메시지 수. 무제한 플랜에서는 null |
unlimited | boolean | 플랜에 일일 한도가 없으면 true |
rejected | integer | 한도에 도달해 오늘 거부된 요청 수 |
resets_at | string | 다음 초기화 시각(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-* 헤더로도 포함됩니다.