API Reference
리디렉션·이벤트 추적 API 엔드포인트와 요청 형식을 설명합니다. 요청 시 X-ADRS-Signature 등 헤더가 필요할 수 있습니다.
리디렉션
추적 코드에 해당하는 목적지 URL로 302 리디렉션합니다. 클릭 시 자동으로 클릭 로그가 기록됩니다.
| 요소 | 설명 |
|---|---|
code | 파트너/링크 고유 추적 코드 (path) |
예시
https://www.adrs.kr/r/abc123
→ 302 Location: (등록된 목적지 URL)
이벤트 기록
전환·리드·가입 등 이벤트를 JSON으로 전송합니다. click_uuid 또는 advertiser_code 중 하나와 event_type이 필수입니다. (HMAC 사용 시 X-ADRS-Signature, X-ADRS-Timestamp 헤더 필요)
| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
event_type | string | ○ | conversion, lead, signup 등 |
advertiser_code | string | ○* | Advertiser(추적) 코드 (click_uuid 없을 때) |
click_uuid | string | ○* | 리디렉션 시 발급된 클릭 식별자 |
order_id | string | - | 주문/전환 고유 ID (중복 방지) |
amount | number | - | 금액 (정산·커미션 계산용) |
currency | string | - | KRW, USD 등 |
metadata | object | - | 추가 데이터 |
Request body
"event_type": "conversion",
"advertiser_code": "partner123",
"order_id": "ORD-12345",
"amount": 50000,
"currency": "KRW"
이벤트 일괄 기록
여러 이벤트를 한 번에 전송합니다. body는 events 배열입니다.
Request body
"events": [
{ "event_type": "conversion", "advertiser_code": "P01", "order_id": "O1" },
{ "event_type": "lead", "click_uuid": "uuid-from-redirect" }
]