05 海关数据接口 - tradewind-api

海关扩展：透传上游 keep1；Bearer {{apiKey}}。

贸易角色：type / company_role / trade_type 常用 importer | exporter（亦兼容 buyer | seller）。

计费（live）：docs/API_CREDITS.md §7 — 国家参考 free；directory 等列表多按条；market-trend / world-regions 等为 按次（低）；match-contacts 按次（搜邮）。

分页 / 别名：mapDirectoryLikeBody 会将 limit 映射为 per_page（见 customs-upstream-body.util.ts）。market-trend 使用 mapMarketTrendBody，limit 与 per_page 会同步。

无 mapBody 的 POST（如 semantic-query / match / match-contacts）：JSON 原样交海关适配器，字段以 keep1 为准；Collection 内示例仅为占位。

错误响应：见 Collection 根节点 info.description 中「统一错误响应」；HTTP 状态码与 error.code 与 ApiExceptionFilter、Swagger ApiStandardErrorResponses 一致。

05 海关扩展 customs（Bearer apiKey）