API Reference · 포스트백

포스트백 목록 조회

매체사가 자신이 받은 포스트백 전송 이력을 조회합니다. 상태/캠페인/사용자 필터와 페이징을 지원합니다.

GET/api/v1/postbacks

요청 파라미터

limit (query, int, default 50, max 200) — 한 페이지에 반환할 항목 수.
offset (query, int, default 0) — 건너뛸 항목 수.
status (query, string, optional) — PENDING / DELIVERED / FAILED 필터.
campaign_id (query, uuid, optional) — 특정 캠페인의 포스트백만 조회.
publisher_user_id (query, string, optional) — 특정 매체사 사용자의 포스트백만 조회.
from (query, ISO 8601, optional) — 조회 시작 시각.
to (query, ISO 8601, optional) — 조회 종료 시각.

요청예시

shell

curl -H "Authorization: Bearer {publisher_secret}" \
     "https://added.blomics.net/api/v1/postbacks?limit=50&status=DELIVERED"

응답 필드

items (array) — 포스트백 객체 배열.
total (int) — 필터에 매치되는 전체 개수.

Item 필드

postback_id (uuid) — 포스트백 식별자.
campaign_id (uuid)
publisher_user_id (string)
event_type (string)
point (int) — 지급 포인트.
status (string) — PENDING / DELIVERED / FAILED.
attempt_count (int) — 재시도 횟수.
last_response_code (int, nullable) — 마지막 응답 코드.
created_at (ISO 8601)
delivered_at (ISO 8601, nullable)

응답예시

json

{
  "items": [
    {
      "postback_id": "0193a1b2-3c4d-5e6f-7890-abcdef012345",
      "campaign_id": "0193b2c3-4d5e-6f78-90ab-cdef01234567",
      "publisher_user_id": "user_12345",
      "event_type": "complete",
      "point": 100,
      "status": "DELIVERED",
      "attempt_count": 1,
      "last_response_code": 200,
      "created_at": "2026-04-30T12:00:00.000Z",
      "delivered_at": "2026-04-30T12:00:01.123Z"
    }
  ],
  "total": 1
}

에러처리

400 INVALID_PARAM — 파라미터 형식 오류 (날짜·UUID·열거값).
401 UNAUTHORIZED — 인증 실패.
500 INTERNAL_ERROR — 서버 오류.