开发者

SDK 下载

SDK 用于封装鉴权、请求签名、幂等键、错误处理和回调校验。当前页面提供接入包组织方式和示例工程入口，实际 SDK 包以商业版后台或源码交付内容为准。

先看 API 文档 查看源码仓库

语言支持计划

如果你的团队需要指定语言 SDK，可在商业版后台提交工单，按项目交付范围获取示例工程或封装包。

Node.js

前后端团队常用

适合 Next.js、Express、NestJS 等业务系统，建议用于服务端调用，不要在浏览器暴露 API Key。

查看鉴权
PHP

站点和代理系统常用

适合传统官网、客户管理系统和订单系统集成，可封装产品、订单和账务接口。

查看订单
Java

企业系统常用

适合 CRM、ERP、财务中台和内部服务接入，建议统一记录 request_id 和业务单号。

查看账务
Go

运维平台常用

适合高并发查询、用量采集和内部自动化平台，建议做好限流和重试控制。

查看用量
Python

脚本和数据分析常用

适合报表、对账、巡检和批量操作。批量任务请使用后台允许的速率。

查看错误码
Webhook 示例

回调接收模板

示例工程应包含签名校验、幂等处理、事件落库和失败重试记录。

查看回调

推荐目录结构

不同语言实现可以不同，但建议都保留统一的客户端、资源模块和错误处理模块。

kuocai-sdk/ client auth request retry errors resources products orders domains usage billing webhook verifier handler examples create-order query-usage receive-webhook

集成前准备

拿到 SDK 或示例工程后，建议先完成下面的基础配置。

环境变量

  • KUOCAI_BASE_URL，开放接口 Base URL。
  • KUOCAI_API_KEY，后台生成的 API Key。
  • KUOCAI_WEBHOOK_SECRET，回调验签密钥，如启用回调签名。

测试用例

  • 查询产品目录并筛选可售套餐。
  • 创建测试订单并查询开通状态。
  • 接收回调并完成幂等处理。
  • 查询账务流水并核对订单金额。

需要指定语言 SDK？

在商业版后台提交工单，说明语言、框架、接口范围和上线时间，便于安排示例工程。

提交工单