技能介绍

在宏观分析或市场调研中，工程师常需要获取国家级别的进出口总额、贸易伙伴分布或同比增长率。手工整理历年海关数据不仅耗时，且容易在国家代码、年份格式等参数上出错。连为全球贸易数据 技能通过封装 Conforx OpenAPI，将自然语言意图转换为结构化的 API 请求，让开发者能直接拉取 2020 年以来的全球贸易统计数据。

鉴权与初始化

所有业务查询前需先获取临时密钥。系统要求调用 POST /openapi/v1/applyTempKey 申请，并在后续请求中携带 Authorization: Bearer <key>。注意，临时 Key 具有严格的硬性限制：同一 IP 最多调用 10 次，每日限申 1 次，且本机回环地址（127.0.0.1）无法执行申请或查询。

核心查询工作流

技能内置四类核心接口，并采用智能参数构建策略：

年度贸易总额：通过 annual/by-country 查询特定国家的进出口数据。若用户询问“历年趋势”，务必省略 year 参数，接口将一次性返回 2020 至今的全量数据。
贸易伙伴分析：利用 partner/by-country 识别主要进出口来源国。
增长率计算：annual-growth/by-country 直接提供同比增长率（growthRate）。
国家代码规范：请求参数强制使用 ISO2 两位代码（如 CN、US），系统会自动拒绝 CHN、USA 等三位代码。

适用边界与注意点

数据范围：仅支持 year >= 2020 的数据，传入 2019 及更早年份会触发参数错误。
资源限额：鉴于临时 Key 仅有 10 次调用额度，触发“Smart Query Strategy”至关重要。除非用户明确指定某一年，否则应尽可能省略 year 和 flowCode 参数，以单次调用获取最宽泛的数据集合。
密钥失效：达到调用上限后，需引导用户申请正式 Key 才能继续使用。