API 文档
所有接口位于 https://claude6666.com/api/v1,请求与响应均为 JSON。机器可读规范:/api/v1/openapi.json(OpenAPI 3.1,可直接导入 Postman / 给 AI Agent 使用)。
鉴权
- 全局令牌:管理后台 →「API 令牌」创建,请求头
Authorization: Bearer sk_live_xxx。令牌拥有创建者(管理员)的全部权限,可接管全站功能;只在创建时显示一次,可设置过期时间和 IP 白名单,所有调用写入审计日志。 - 浏览器会话:登录后使用
sidCookie(网站前端使用)。
约定
- 成功:
{"ok":true,"data":...};失败:{"ok":false,"error":{"code":"...","message":"..."}},HTTP 状态码 400/401/403/404/409/429/500。 - 金额单位均为分(整数),例如 25000 = ¥250.00。时间为 ISO 8601(UTC)。
- 写操作可带
Idempotency-Key请求头,24 小时内相同 Key 返回首次结果,避免重复下单/重复交付。 - 列表接口支持
page、pageSize,返回{items,total,page,pageSize}。
示例:AI Agent 自动交付
# 1. 拉取已付款待交付订单
curl -H "Authorization: Bearer $TOKEN" "https://claude6666.com/api/v1/orders?status=PAID"
# 2. 交付(dashboardUrl 不填使用后台默认值,额度链接自动生成为 dashboardUrl#key=apiKey)
curl -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-H "Idempotency-Key: deliver-ORDER_ID" \
-d '{"apiKey":"sk-vm-xxxx"}' "https://claude6666.com/api/v1/orders/ORDER_ID/deliver"认证
POST
/api/v1/auth/register公开邮箱注册(必须填邀请码)
Body
email stringpassword string ≥8inviteCode string 必填nickname string?POST
/api/v1/auth/login公开登录,写入 sid Cookie
Body
email stringpassword stringPOST
/api/v1/auth/logout可选登录退出登录
POST
/api/v1/auth/verify-email公开用邮件中的 token 验证邮箱
Body
token stringPUT
/api/v1/auth/verify-email登录用户重新发送验证邮件
POST
/api/v1/auth/forgot-password公开发送重置密码邮件
Body
email stringPOST
/api/v1/auth/reset-password公开重置密码
Body
token stringpassword string ≥8GET
/api/v1/me登录用户当前用户、邀请的人、续费券
PATCH
/api/v1/me登录用户修改昵称/微信号/二维码(代理&管理员)/密码
Body
nickname string?wechatId string?wechatQr url?password { old, new }?下单
GET
/api/v1/context可选登录当前访客上下文:按代理返回的套餐价格、联系人微信、支付模式
Query
ref 邀请码(可选)GET
/api/v1/plans可选登录套餐列表(管理员 ?all=1 含成本)
POST
/api/v1/quote登录用户试算价格(折扣码/续费券自动取最优,不叠加)
Body
planId stringtype NEW|RENEWsubscriptionId 续费时必填discountCode string?useCoupon boolean?订单
GET
/api/v1/orders登录用户订单列表(按角色限定范围)
Query
status PENDING,PAID,...q 订单号/邮箱userId agentId 管理员mine 1=只看自己page pageSize ≤100POST
/api/v1/orders登录用户创建订单并发起支付(失败自动转人工)。令牌可传 userId 代用户下单
Body
planId stringtype NEW|RENEWsubscriptionId string?discountCode string?useCoupon boolean?payType alipay|wxpayuserNote string?userId 管理员可选GET
/api/v1/orders/{id}登录用户订单详情(id 或订单号),含收款联系人
PATCH
/api/v1/orders/{id}管理员管理员备注
Body
adminNote stringPOST
/api/v1/orders/{id}/pay登录用户重新发起在线支付
Body
payType alipay|wxpayPOST
/api/v1/orders/{id}/cancel登录用户取消待支付订单(释放折扣码/续费券)
POST
/api/v1/orders/{id}/confirm-payment代理/管理员人工确认收款(管理员任意;代理仅限收款人是自己的订单)
POST
/api/v1/orders/{id}/deliver管理员交付:填 apiKey 即可,其余用默认值;生成额度链接 dashboardUrl#key=apiKey 并发邮件
Body
apiKey string 必填dashboardUrl string?anthropicBaseUrl string?openaiBaseUrl string?note string?POST
/api/v1/orders/{id}/refund管理员退款(viaGateway=true 原路退回)
Body
amount 分,默认全额viaGateway booleanreason string?订阅
GET
/api/v1/subscriptions登录用户订阅(已交付服务)列表
Query
status ACTIVE,EXPIREDq mine 1GET
/api/v1/subscriptions/{id}登录用户订阅详情(本人/管理员可见完整 Key)
PATCH
/api/v1/subscriptions/{id}管理员换 Key/改到期时间/改状态
Body
apiKey string?dashboardUrl string?endAt ISO 时间?status ACTIVE|EXPIRED|CANCELLED?notify boolean 是否重发邮件优惠
GET
/api/v1/coupons登录用户我的续费券(管理员 ?all=1)
POST
/api/v1/coupons管理员手动发券
Body
userId stringamount 分?validDays number?DELETE
/api/v1/coupons/{id}管理员作废未使用的券
GET
/api/v1/discount-codes代理/管理员折扣码列表(代理只看自己的)
POST
/api/v1/discount-codes代理/管理员创建折扣码(代理的码只对其名下用户有效,折扣由代理承担)
Body
code string? 留空自动生成type AMOUNT|PERCENTvalue AMOUNT=分;PERCENT=1-100planId string?orderType ALL|NEW|RENEWmaxUses number?perUserLimit numberexpiresAt ISO?active booleannote string?PATCH
/api/v1/discount-codes/{id}代理/管理员修改折扣码
DELETE
/api/v1/discount-codes/{id}代理/管理员删除(已使用过则停用)
代理
GET
/api/v1/agent/stats代理/管理员代理概览(管理员可 ?agentId=)
GET
/api/v1/agent/users代理/管理员代理名下用户
GET
/api/v1/agent/prices代理/管理员代理价格表(成本/最高/当前售价)
PUT
/api/v1/agent/prices代理/管理员代理设置售价(须在成本价~最高价之间,null 恢复零售价)
Body
planId stringprice 分|nullGET
/api/v1/agent/ledger代理/管理员代理账本与余额(>0 平台应付代理)
管理
GET
/api/v1/admin/stats管理员经营概览
GET
/api/v1/admin/users管理员用户列表
Query
role q agentId POST
/api/v1/admin/users管理员创建用户/代理
Body
email password role USER|AGENT|ADMINagentId string?GET
/api/v1/admin/users/{id}管理员用户详情
PATCH
/api/v1/admin/users/{id}管理员改角色/归属代理/禁用/重置密码/微信
Body
role ?agentId ?disabled ?password ?wechatId ?wechatQr ?emailVerified ?GET
/api/v1/admin/agents管理员代理列表与业绩
GET
/api/v1/admin/agents/{id}/prices管理员某代理价格表
PUT
/api/v1/admin/agents/{id}/prices管理员设置代理成本价/最高售价
Body
planId stringcostPrice 分|nullmaxPrice 分|nullPOST
/api/v1/plans管理员新建套餐
Body
slug name retailPrice 分defaultAgentCost 分defaultMaxPrice 分durationDays 30features string[]PATCH
/api/v1/plans/{id}管理员修改套餐
DELETE
/api/v1/plans/{id}管理员删除套餐(有订单则下架)
GET
/api/v1/admin/ledger管理员全部账本流水
POST
/api/v1/admin/ledger管理员结算/调整(平台付代理 X → amount=-X)
Body
agentId type SETTLEMENT|ADJUSTamount 分(可负)note GET
/api/v1/admin/settings管理员系统设置 + 环境配置状态
PATCH
/api/v1/admin/settings管理员修改系统设置(支付模式、券金额、交付默认值等)
GET
/api/v1/admin/payment管理员支付商户信息与回调日志
POST
/api/v1/admin/payment管理员主动查单补单
Body
orderNo stringGET
/api/v1/admin/emails管理员邮件发送记录
POST
/api/v1/admin/emails管理员发送测试邮件
Body
to emailPOST
/api/v1/admin/emails/{id}/retry管理员重发失败邮件
GET
/api/v1/admin/tokens管理员API 令牌列表
POST
/api/v1/admin/tokens管理员创建 API 令牌(仅网页登录态;明文只显示一次)
Body
name expiresInDays number?ipAllowlist 逗号分隔?DELETE
/api/v1/admin/tokens/{id}管理员吊销令牌
GET
/api/v1/admin/audit-logs管理员审计日志
内容
GET
/api/v1/articles可选登录文章列表(管理员 ?all=1 含草稿)
POST
/api/v1/articles管理员新建文章(Markdown)
Body
slug title summary content markdowncategoryId ?tags 逗号分隔status DRAFT|PUBLISHEDseoTitle ?seoDescription ?GET
/api/v1/articles/{id}可选登录文章详情(id 或 slug)
PATCH
/api/v1/articles/{id}管理员修改文章
DELETE
/api/v1/articles/{id}管理员删除文章
GET
/api/v1/categories公开分类列表
POST
/api/v1/categories管理员新建分类
Body
name slug sort 0POST
/api/v1/uploads代理/管理员上传图片 multipart 字段 file ≤2MB,返回 url