# DCinside RTB API Documentation

- [Overview](https://surf-dcinside-api.kr.ask.surf/overview.md): DCinside RTB API - publish scores for the Real-Time Best candidate pool
- [Conventions](https://surf-dcinside-api.kr.ask.surf/conventions.md): Base URL, authentication, formats, idempotency and limits shared by every call
- [How Scoring Works](https://surf-dcinside-api.kr.ask.surf/scoring.md): The publish score, when a post is scored, what the model reads and how the weights work
- [Rollout Stages](https://surf-dcinside-api.kr.ask.surf/rollout.md): Dress rehearsal, stage 1 and stage 2: what runs when, what counts as a pass, and what is still to settle
- [Errors](https://surf-dcinside-api.kr.ask.surf/errors.md): Error body, status codes and what to do for each
- [Score a Cycle](https://surf-dcinside-api.kr.ask.surf/cycles.md): One call per five-minute cycle. Sends candidates, engagement, candidate scores and removals, and returns a status and publish score for every pending candidate.
- [Get Cycle Scores](https://surf-dcinside-api.kr.ask.surf/scores.md): The stored response for a cycle, byte for byte. Use it after a timeout or a lost response.
- [Upload an Image](https://surf-dcinside-api.kr.ask.surf/images.md): Uploads one image of a post, once per image, in the background. Never on the scoring path.
- [Send Outcomes](https://surf-dcinside-api.kr.ask.surf/outcomes.md): How placed posts performed, one record per placement, with readings at 1, 6, 24 and 48 hours. This is what the model learns from.
- [Set Weights](https://surf-dcinside-api.kr.ask.surf/set-weights.md): Sets the weights of the publish score. They apply from the next cycle.
- [Get Weights](https://surf-dcinside-api.kr.ask.surf/get-weights.md): The publish-score weights in force, and the version before them.
- [Health](https://surf-dcinside-api.kr.ask.surf/health.md): Service state, versions in use and the last cycle received.

## OpenAPI Specs

- [openapi](/openapi.json)