开发者 API 能做什么：行情数据、上架自动化与错误码总览
API 定位
平台为开发者提供公开 HTTP API，能力覆盖三块：
- 读取市场数据：在售列表、单品详情、价格与流动性信息。
- 交易自动化：通过接口上架物品（buy_now 或 auction 类型）。
- 工具集成：第三方站点接入同一套验货与检视数据（平台的检视系统本身已开源并被业内广泛采用）。
官方文档站（docs 子域）给出全部端点与参数，本板块节选最常用的 listings 部分。
设计风格
- REST 风格，返回 JSON。
- 需要鉴权的端点通过请求头传 API Key（见 API 鉴权）。
- 列表类接口用游标分页（cursor），单页上限 50 条。
错误码表
标准 HTTP 状态码语义（官方文档口径）：
| 码 | 含义 |
|---|---|
| 400 | 请求参数无效 |
| 401 | API Key 错误或缺失 |
| 403 | 无权访问该资源 |
| 404 | 资源不存在 |
| 405 | HTTP 方法不正确 |
| 406 | 请求的格式不是 JSON |
| 410 | 资源已从服务器移除 |
| 429 | 请求过于频繁——降低速率 |
| 500 | 服务端错误，稍后重试 |
| 503 | 服务暂时不可用（维护中） |
429 是最常遇到的一个：写脚本时务必做退避重试（比如 429 后等待指数增长的间隔），否则会持续被限流。
适合做什么
| 用途 | 思路 |
|---|---|
| 价格监控 | 定时拉 listings，比对目标款式的价格与折扣 |
| 极品哨兵 | 用 min_float/max_float 参数轮询低浮点新上架 |
| 自动上架 | 库存变动时通过 POST 接口同步上架 |
| 数据分析 | 结合排序与筛选参数批量抓取做行情统计 |
纪律建议
- 控制请求频率，尊重 429。
- API Key 只放在服务端，不要打进前端代码（防钓鱼意识同样适用于此，见 安全交易清单）。
- 功能与参数可能随版本变化，以官方文档为准。