API 文档中心
pddun.net 开发者API网关与开发中心 · 统一接口契约 v1。所有金额单位为分，时间为 Unix 秒或 ISO。
基址与鉴权
公网边缘基址：https://a2ahub.com.cn/api。业务请求在 Header 携带开发者 Token：
Authorization: Bearer <app_key> X-Dev-App: <developer_uid>
pddun.net 网关负责把请求路由到对应能力体；上游 Coze/Dify/豆包/DeepSeek 差异对调用方透明。
统一响应包络
成功：{"code":0,"msg":"ok","data":{...}}；失败：{"code":<非0>,"msg":"<中文错误>","data":null}。
{
"code": 0,
"msg": "ok",
"data": { "/* 各接口结构见下 */": true }
}
错误码
| code | 含义 | 处理建议 |
|---|---|---|
| 0 | 成功 | 读取 data |
| 40101 | 未携带 / 非法 Token | 检查 Authorization 头 |
| 40301 | 该工具需要购买后使用 | 引导至下单 |
| 40302 | 今日免费体验次数已用完 | 升级会员或次日再试 |
| 40303 | 会员已到期 | 续费 |
| 42901 | 触发限流 | 退避重试 |
| 50000 | 网关/上游异常 | 故障安全：绝不放行，稍后重试 |
GET 商品列表
/api/store/goods/list
| 参数 | 类型 | 说明 |
|---|---|---|
| keyword | string | 关键词，可选 |
| industry | string | 行业：门店经营/办公效率/文案创作… |
| price_type | string | all/free/single/member |
| page / page_size | int | 默认 1 / 12 |
curl "https://a2ahub.com.cn/api/store/goods/list?page=1&page_size=2"
→ {"code":0,"data":{"total":8,"list":[{"goods_id":1,"title":"餐饮菜单优化师",
"single_price":1990,"price_type":"single",...}]}}
GET 商品详情
/api/store/goods/detail?goods_id=
返回商品全字段 + creator_name + member_plans，并使 view_count +1。
POST 创建订单
/api/store/order/create
{"goods_id":1,"plan_type":"single","channel":"wechat"}
→ {"code":0,"data":{"order_id":"PDD...","pay_mode":"sandbox",
"sandbox_settle_path":"/api/a2ahub/sandbox/settle"}}
沙箱结算不真实扣款；免费品直接返回 order_status=paid。
POST 能力鉴权
/api/a2ahub/skill/auth
{"uid":"YOUR_UID","skill_id":"codeagent"}
→ {"code":0,"data":{"allowed":true,"permission_type":1,"remain_quota":19}}
免费每日 20 次；单次永久/会员按到期判断。鉴权服务异常时绝不放行。
POST 沙箱结算
/api/a2ahub/sandbox/settle，body {"order_id":"..."}，等价支付成功链路并标注「模拟支付」。
POST 创建应用
/api/dev/app/create
{"developer_uid":"YOUR_UID","app_name":"我的门店系统"}
→ {"code":0,"data":{"app_id":"A...","app_key":"pk_...",
"app_secret":"sk_...(仅此一次明文返回)","status":"active"}}
GET 应用列表
/api/dev/app/list?developer_uid=，app_secret 脱敏为 ****后4位。
POST 重置密钥
/api/dev/app/rotate，body {"app_id":"..."}，返回新 app_secret。
POST 吊销应用
/api/dev/app/revoke，body {"app_id":"..."}，置 status=revoked，立即失效。
GET 用量查询
/api/dev/usage?developer_uid=&app_id=
{"code":0,"data":{"total_calls":1280,"success_rate":99.2,
"avg_latency_ms":320,
"series":[{"stat_day":"2026-09-06","calls":180,"errors":2,"latency":310}]}}