Knobase전환 이벤트
반환된 오퍼 스냅샷에 대한 서명된 전환을 기록합니다.
이전에 반환된 오퍼의 서명된 전환을 기록합니다.
인증
Bearer serving key가 필요합니다. 서명은 별도로 검증됩니다.
요청 본문
| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
| offer_snapshot_id | string (`snp_…`) | 예 | Snapshot id from the decide response. |
| decision_id | string (`dec_…`) | 아니오 | Related decision id. |
| timestamp | integer (ms) | 예 | Must be within ±10 minutes of the server clock. |
| nonce | string (8–80) | 예 | One-time value used in the signature. |
| signature | string (min 16) | 예 | Knobase-issued conversion signature. Do not invent a signing secret. |
V1 응답은 billable: false, ledger_written: false입니다. 서명 비밀을 만들거나 서버 환경 변수 이름을 공개하지 마세요.
요청 예제
curl -sS -X POST "https://knobase.com/v1/events/conversion" \
-H "Authorization: Bearer $KNOBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"offer_snapshot_id":"snp_01EXAMPLEOFFER","decision_id":"dec_01","timestamp":1757491200000,"nonce":"nonce_example_01","signature":"aaaaaaaaaaaaaaaa"}'응답
{
"ok": true,
"inserted": true,
"event_id": "evt_02",
"offer_snapshot_id": "snp_01EXAMPLEOFFER",
"billable": false,
"ledger_written": false
}오류
| HTTP | error | 상황 |
|---|---|---|
| 401 | auth errors | 없거나 잘못된 serving key |
| 401 | invalid_signature | 서명 불일치 |
| 400 | invalid_conversion | 본문 검증 실패 |
| 400 | expired_conversion | timestamp가 ±10분을 벗어남 |