OpenAPI 缺口(代码有,公开 Postman 无)¶
下列 ptrader-api-gateway /openapi 路由存在于代码中,但不在已锁定的 Postman 范围内(或仅部分覆盖)。在产品将其加入集合或明确批准前,不要当作已支持对外能力文档化。
| Method | Path | Controller | 说明 |
|---|---|---|---|
| POST | /openapi/fiat[/v1]/generate_qr_code |
FiatOpenApiController |
QR 写入 |
| POST | /openapi/fiat[/v1]/generate/static/qr_code |
同上 | |
| POST | /openapi/fiat[/v1]/update/qr_code |
同上 | |
| POST | /openapi/fiat[/v1]/decode/kyb_qr_code |
同上 | |
| GET | /openapi/v1/sub-account/apikey/ip-restriction |
SubAccountController |
|
| POST | /openapi/v1/sub-account/apikey/add-ip-restriction |
同上 | |
| POST | /openapi/v1/sub-account/apikey/delete-ip-restriction |
同上 | |
| GET | /openapi/migration/v4/payout-outlets/{id} |
FiatMigrationApiController |
列表路径已在 Postman;按 id 变体未收录 |
| GET | /openapi/migration/v4/payout-outlet-categories/{id} |
同上 |
部分控制器上的遗留别名如 /openapi/order-new/... — 除非加入 Postman,否则视为非公开。
已纳入范围内但仍不完整的项¶
- 来自 Java DTO 的完整请求/响应 JSON Schema
- 逐接口错误码列表
- 逐接口限流 weight