Tìm nhanh
Đi tới trang, app, bidder hoặc network
Đi tới trang, app, bidder hoặc network
Sinh tự động từ chính các Zod schema đang validate 3 route /config/v1, /openrtb2/auction, /events/v1/batch (IAM-10 §5–§7), nên spec và server không thể lệch nhau. Schema: SdkConfig, AuctionRequest, AuctionResponse, EventBatch, EventBatchResponse, Health, Error. Bản tĩnh: docs/openapi.json (npm run openapi:export).
/config/v1/{appKey}· Fetch the published config for an appConfigSend `If-None-Match` with the last ETag; `304` means keep the cached config. Cache for `ttl_seconds`; on `404` or network error keep the cached copy (BR-CFG-07). The `kill` block changes the ETag immediately when a kill switch is set.
/openrtb2/auction· Run an auction for one ad unitAuctionOne `imp` per request. `imp[0].ext.prebid.storedrequest.id` = adUnitId, `ext.prebid.storedrequest.id` = appKey. The server resolves the Stored Imp of the running config version, runs a first-price auction with `tmax` and the floor, and answers within `tmax`. `200` with an empty `seatbid` is NO_FILL (BR-AUC-04).
/events/v1/batch· Send a batch of SDK eventsEventsSignature: `X-IAM-Signature = hex(HMAC-SHA256(eventSecret, X-IAM-Timestamp + rawBody))` where `eventSecret` is the per-app secret shown on the Dashboard. Flush every `event.flush_interval_seconds`, when `event.batch_size` is reached, or when the app goes to background. Keep an offline queue (max `event.max_queue`) and retry; the server dedupes on `event_id`.
/events/v1/burl· Billing URLEventsOpaque URL taken from `bid.burl`; fire it exactly once on the first valid impression, then send the `impression` event with `extra.burl_status`.
/healthz· Liveness / readinessOps