语言支持策略
- REST+JSON:任意语言(Python/Node/Java/Go/PHP/C#等)直接HTTP调用;
- MCP/A2A:遵循开放协议,可用社区SDK;
- 官方示例:优先Python、Node.js,逐步补充Java;
- 签名与鉴权示例随开发者文档提供。
通用调用要素
无论何种语言,都需要:Base URL、API Key请求头、JSON请求体、对429/5xx的重试、对返回JSON的双口径字段处理。建议封装统一客户端,集中处理鉴权、重试与日志。
零依赖原则
因为接口是标准REST,即使没有官方SDK,也可用各语言内置HTTP库在十几行代码内完成一次工具调用。