본문으로 건너뛰기

웹훅 기록 GET ​

특정 웹훅으로 들어온 요청의 기록을 조회합니다. 어떤 데이터가 전송되었는지, 메시지가 어떻게 렌더링되었는지, 알림이 전달되었는지 확인할 수 있습니다.

엔드포인트 ​

GET https://api.pocketalert.app/v1/webhooks/{tid}/history

인증 ​

필수

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

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

요청 ​

경로 매개변수 ​

매개변수타입필수설명
tidstring✅웹훅 고유 식별자

쿼리 매개변수 ​

매개변수타입기본값설명
pageinteger1페이지 번호
perinteger50페이지당 항목 수 (최대 200)
statusstring—결과로 필터링: success 또는 error

요청 예시 ​

bash
curl -X GET "https://api.pocketalert.app/v1/webhooks/kblf7mh9j8jjyeh4fx/history?per=25&status=error" \
  -H "Token: your-api-key"
javascript
const tid = 'kblf7mh9j8jjyeh4fx';
const response = await fetch(`https://api.pocketalert.app/v1/webhooks/${tid}/history?per=25`, {
  headers: { 'Token': 'your-api-key' }
});
const history = await response.json();
python
import requests

tid = 'kblf7mh9j8jjyeh4fx'
response = requests.get(
    f'https://api.pocketalert.app/v1/webhooks/{tid}/history',
    headers={'Token': 'your-api-key'},
    params={'per': 25, 'status': 'error'}
)
print(response.json())

응답 ​

성공 응답 ​

200 OK

최신순으로 정렬된 요청 목록을 페이지 단위로 반환합니다

필드타입설명
requestsarray기록된 요청 목록
totalinteger보관 기간 내 전체 요청 수
pageinteger현재 페이지
perinteger페이지당 항목 수
retention_daysinteger플랜에서 기록을 보관하는 일수 (0 = 무제한)
webhookobjecttid, name, url, is_active

requests의 각 항목:

필드타입설명
idinteger요청 식별자
methodstring발신자가 사용한 HTTP 메서드
source_ipstring호출자 IP 주소
content_typestring요청 콘텐츠 타입
querystring원본 쿼리 문자열
headersobject요청 헤더 (민감한 값은 가려집니다)
bodystring요청 페이로드
sizeinteger페이로드 크기(바이트)
statusstringsuccess 또는 error
error_codestring실패 사유, 성공 시 빈 값
rendered_messagestring템플릿으로 생성된 메시지
message_tidstring생성된 메시지의 식별자, 실패 시 빈 값
priorityinteger적용된 알림 수준
duration_msinteger처리 시간
created_atstring요청이 도착한 시각
json
{
  "requests": [
    {
      "id": 412,
      "method": "POST",
      "source_ip": "140.82.115.16",
      "content_type": "application/json",
      "query": "",
      "headers": { "User-Agent": "GitHub-Hookshot", "Authorization": "[redacted]" },
      "body": "{\"repository\":{\"name\":\"pocketalert\"}}",
      "size": 38,
      "status": "success",
      "error_code": "",
      "rendered_message": "Push to pocketalert",
      "message_tid": "yrst1db64dbbe7euurpmanhdy",
      "priority": 1,
      "duration_ms": 24,
      "created_at": "18.07.2026 16:45:06"
    }
  ],
  "total": 1,
  "page": 1,
  "per": 50,
  "retention_days": 90,
  "webhook": {
    "tid": "kblf7mh9j8jjyeh4fx",
    "name": "GitHub Push",
    "url": "cs994rqfkk8ljngt",
    "is_active": true
  }
}

에러 코드 ​

status가 error인 경우, error_code에서 실패 원인을 확인할 수 있습니다:

코드의미
inactive웹훅이 비활성화되어 있어 알림이 전송되지 않았습니다
invalid_json페이로드를 JSON으로 파싱할 수 없습니다
empty_message템플릿이 빈 문자열로 해석되었습니다. 보통 페이로드에 존재하지 않는 %path%가 원인입니다
encryption_failed메시지를 암호화할 수 없습니다
save_failed메시지를 저장할 수 없습니다
daily_limit계정의 일일 메시지 한도에 도달했습니다. 호출은 429를 받았고 알림은 전송되지 않았습니다. 페이로드와 렌더링된 메시지는 여기에 보관됩니다

에러 응답 ​

상태 코드설명
401인증 실패 — 토큰이 잘못되었거나 없습니다
404찾을 수 없음 — 웹훅이 존재하지 않습니다

참고 사항 ​

보관 기간

기록은 플랜에 따라 일정 기간 동안 보관됩니다 (retention_days 참고): 무료 플랜 7일, 스타터 30일, 미디엄 90일, 라지 365일입니다. 보관 기간이 지난 요청은 자동으로 삭제되며, 웹훅 하나의 기록이 1,000건을 넘으면 가장 오래된 항목부터 자동으로 삭제됩니다.

개인정보

페이로드는 메시지 내용과 같은 방식으로 개인 키를 사용해 저장 시 암호화됩니다. 저장 전에 Authorization, 쿠키, API 키 헤더는 [redacted]로 대체됩니다.

Pocket Alert 문서