고객센터어드민

API Reference · 포스트백

포스트백 상세 조회

단건 포스트백 상세 — 요청 페이로드, 응답 코드/본문, 재시도 이력 등을 포함하여 디버깅에 사용합니다.

GET/api/v1/postbacks/{postback_id}

요청 파라미터

  • postback_id (path, uuid, required) — 조회할 포스트백 ID.

요청예시

shell
curl -H "Authorization: Bearer {publisher_secret}" \
     "https://added.blomics.net/api/v1/postbacks/0193a1b2-3c4d-5e6f-7890-abcdef012345"

응답 필드

200 OK — 포스트백 객체 + 페이로드/응답 본문/재시도 이력.

  • postback_id (uuid)
  • campaign_id (uuid)
  • publisher_user_id (string)
  • event_type (string)
  • point (int)
  • status (string) — PENDING / DELIVERED / FAILED.
  • attempt_count (int)
  • request_url (string) — 호출 대상 URL.
  • request_method (string) — GET / POST.
  • request_payload (object, nullable) — 요청 본문/쿼리.
  • last_response_code (int, nullable)
  • last_response_body (string, nullable) — 직전 응답 본문 (truncated).
  • attempts (array) — 재시도별 결과.
    • attempt_no (int)
    • status_code (int, nullable)
    • error (string, nullable)
    • tried_at (ISO 8601)
  • created_at (ISO 8601)
  • delivered_at (ISO 8601, nullable)

응답예시

json
{
  "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,
  "request_url": "https://publisher.example.com/postback?uid={uid}",
  "request_method": "GET",
  "request_payload": null,
  "last_response_code": 200,
  "last_response_body": "{\"ok\":true}",
  "attempts": [
    { "attempt_no": 1, "status_code": 200, "error": null,
      "tried_at": "2026-04-30T12:00:01.000Z" }
  ],
  "created_at": "2026-04-30T12:00:00.000Z",
  "delivered_at": "2026-04-30T12:00:01.123Z"
}

에러처리

  • 400 INVALID_PARAM — postback_id 형식 오류.
  • 401 UNAUTHORIZED — 인증 실패.
  • 404 NOT_FOUND — 포스트백 없음 또는 소유권 위반.
  • 500 INTERNAL_ERROR — 서버 오류.