Knobase렌더 이벤트
Record that an existing native surface showed a returned offer.
기존 네이티브 표면이 반환된 오퍼를 보여 주었음을 기록합니다.
정규 경로는 POST /v1/events/rendered와 POST /v1/events/qualified-impression입니다. POST /v1/events/impression은 별칭입니다. Idempotency-Key 헤더를 권장합니다.
인증
Bearer serving key가 필요합니다.
요청 본문
| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
| offer_snapshot_id | string (`snp_…`) | 예 | Snapshot id from `offer_id` on the decide response. |
| decision_id | string (`dec_…`) | 아니오 | Decision that returned the offer. |
| type | "offer_rendered" | "qualified_impression" | 아니오 | Defaults to `offer_rendered` when omitted. |
| Idempotency-Key | header string (8–80) | 예 | Canonical retry key. Body idempotency_key remains accepted on the impression alias. |
type: "offer_rendered"을 보내세요. 생략하면 기본값입니다.
요청 예제
curl -sS -X POST "https://knobase.com/v1/events/rendered" \
-H "Authorization: Bearer $KNOBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"offer_snapshot_id":"snp_01EXAMPLEOFFER","decision_id":"dec_01","type":"offer_rendered","idempotency_key":"idemp_rendered_01"}'응답
{
"ok": true,
"inserted": true,
"event_id": "evt_01",
"offer_snapshot_id": "snp_01EXAMPLEOFFER",
"type": "offer_rendered",
"billable": false
}오류
| HTTP | error | 상황 |
|---|---|---|
| 401 | auth errors | 없거나 잘못된 serving key |
| 400 | invalid_event | 본문 검증 실패 |
| 404 | unknown_snapshot | 알 수 없는 offer_snapshot_id |