预览版本 · 待总指挥审查,未上线(本页不覆盖正式页面)|返回正式首页

接入指南

从注册到上线,五步完成。每一步都有对应模块可直接操作。

1

注册开发者

使用企业账号登录 pddun.net 开发者中心;演示环境通过右上角「演示身份」切换 U10001 / C20001 / ADMIN。

2

创建应用

进入 密钥管理,填写应用名称并创建,得到 app_key 与 app_secret。

3

获取密钥

app_secret 仅创建/重置时明文展示一次,请立即存入服务端环境变量,勿写入前端代码。

Authorization: Bearer <app_key>   # 每次请求携带
4

联调

先用 在线调试 跑通鉴权与一个能力接口,再参照 SDK 示例 接入自己的代码。

POST /api/a2ahub/skill/auth  {"uid":"U10001","skill_id":"codeagent"}
→ allowed:true, remain_quota:19
5

上线

用量看板 确认调用成功率与延迟,灰度放量;错误码与限流见 API 文档

安全提醒:app_secret 等同你的应用密码,仅存服务端;不要硬编码到小程序前端或提交到 Git。如怀疑泄漏,立即在「密钥管理」重置或吊销。