汇知保OpenAPI接入助手

解决客户端集成的重复劳动

对接 OpenAPI 服务时，开发者常需在 token 交换、请求封装、错误码映射和限流处理上反复试错。本技能聚焦客户端集成，帮你快速生成符合规范的请求示例、理解统一响应结构，并处理常见的认证与授权失败场景。

核心能力与工作流

1. 输入收集：在生成具体请求前，明确 baseUrl、appKey、appSecret 等关键参数。
2. 认证流程：指导从 appKey/appSecret 换取 accessToken，并在遇到 OPEN_INVALID_TOKEN 时安全刷新重试。
3. 请求生成：提供 curl、JavaScript、Python 和 Postman 的客户端示例，覆盖账户、产品、订单、钱包等常见业务域。
4. 错误诊断：解析 401/403/429 等 HTTP 状态及 OPEN_* 错误码，给出客户端可执行的修复建议。
5. 安全审查：确保输出不泄露 appSecret、Cookie 或原始堆栈，推荐脱敏日志和占位符实践。

适用边界与注意点

• 本技能仅用于公共 API 客户端集成，不涉及服务端内部实现（如数据库迁移、框架拦截器）。
• 假设遵循 /openapi/v1/ 路径、统一 envelope 和 code === "OK" 的成功判断；若实际 API 不同，需调整约定。
• 严禁建议禁用认证或绕过作用域检查；速率限制优先采用指数退避而非盲目重试。