| 项目 | 值 |
|---|---|
| API基础URL | https://api.pddun.com/v1 |
| 沙箱环境URL | https://sandbox-api.pddun.com/v1 |
| 数据格式 | JSON |
| 字符编码 | UTF-8 |
| 限流策略 | 基础版100次/分钟，专业版1000次/分钟，企业版10000次/分钟 |
GET /api/v1/skills HTTP/1.1 Host: api.pddun.com Authorization: Bearer YOUR_API_KEY Content-Type: application/json
| 方法 | 路径 | 描述 |
|---|---|---|
| GET | /skills | 获取可用Skill列表 |
| GET | /skills/[skill_id] | 获取Skill详情 |
| POST | /skills/[skill_id]/execute | 执行Skill |
| GET | /skills/[skill_id]/tasks | 获取Skill任务列表 |
| GET | /skills/[skill_id]/tasks/[task_id] | 获取任务状态 |
| POST | /skills/[skill_id]/tasks/[task_id]/cancel | 取消任务 |
| 方法 | 路径 | 描述 |
|---|---|---|
| POST | /mcp/a2a/agent-card | 注册/更新Agent Card |
| GET | /mcp/a2a/agents | 发现可用智能体 |
| GET | /mcp/a2a/agents/[agent_id] | 获取智能体详情 |
| POST | /mcp/a2a/tasks | 创建任务 |
| GET | /mcp/a2a/tasks/[task_id] | 获取任务状态 |
| POST | /mcp/a2a/tasks/[task_id]/messages | 发送消息 |
| GET | /mcp/a2a/tasks/[task_id]/messages | 获取消息列表 |
| POST | /mcp/a2a/tasks/[task_id]/complete | 完成任务 |
| POST | /mcp/a2a/tasks/[task_id]/cancel | 取消任务 |
| POST | /mcp/a2a/payments | 创建支付 |
| GET | /mcp/a2a/payments/[payment_id] | 获取支付状态 |
| 方法 | 路径 | 描述 |
|---|---|---|
| GET | /mcp/store/info | 获取门店信息 |
| GET | /mcp/store/products | 获取商品列表 |
| GET | /mcp/store/products/[sku] | 获取商品详情 |
| POST | /mcp/store/products | 创建/更新商品 |
| GET | /mcp/store/inventory | 获取库存信息 |
| POST | /mcp/store/inventory/adjust | 调整库存 |
| GET | /mcp/store/orders | 获取订单列表 |
| GET | /mcp/store/orders/[order_id] | 获取订单详情 |
| POST | /mcp/store/orders | 创建订单 |
| GET | /mcp/store/customers | 获取会员列表 |
| GET | /mcp/store/customers/[customer_id] | 获取会员详情 |
| POST | /mcp/store/customers | 创建/更新会员 |
| GET | /mcp/store/sales/daily | 获取日销售数据 |
| GET | /mcp/store/sales/ranking | 获取销售排行 |
| POST | /mcp/store/webhooks | 注册Webhook |
| 状态码 | 错误码 | 描述 |
|---|---|---|
| 400 | INVALID_PARAMETER | 请求参数错误 |
| 401 | UNAUTHORIZED | 认证失败 |
| 403 | FORBIDDEN | 无权限访问 |
| 404 | NOT_FOUND | 资源不存在 |
| 409 | CONFLICT | 资源冲突 |
| 422 | UNPROCESSABLE_ENTITY | 业务逻辑错误 |
| 429 | RATE_LIMIT_EXCEEDED | 请求频率超限 |
| 500 | INTERNAL_ERROR | 服务器内部错误 |
| 502 | BAD_GATEWAY | 网关错误 |
| 503 | SERVICE_UNAVAILABLE | 服务不可用 |