POST
/api/v1/redeem/direct创建直充订单
客户端传入兑换码和完整 ChatGPT Session 对象;同一码重复提交会返回原订单。
curl -X POST "https://your-domain/api/v1/redeem/direct" \
-H "Content-Type: application/json" \
-d '{
"redeemCode": "GETAI-XXXXX-XXXXX-XXXXX-XXXXX",
"token": {
"user": { "email": "user@example.com" },
"account": { "id": "account-example" },
"accessToken": "<chatgpt_access_token>",
"sessionToken": ""
}
}'redeemCode必填,后台生成的完整兑换码
token必填,建议原样传递完整 Session JSON
token.user.emailSession 内必填,目标邮箱
token.account.id + accessTokenSession 内必填,账号 ID 与有效 JWT
POST
/api/v1/redeem/status查询订单状态
使用同一兑换码查询最新状态;处理中订单会同时向上游同步。
curl -X POST "https://your-domain/api/v1/redeem/status" \
-H "Content-Type: application/json" \
-d '{ "redeemCode": "GETAI-XXXXX-XXXXX-XXXXX-XXXXX" }'pendingprocessingsuccessfailed
统一响应
客户端必须同时判断 HTTP 状态码与业务 code。
{
"code": 0,
"message": "success",
"data": {
"order_no": "MC260803...",
"status": "processing",
"email": "user@example.com"
}
}2xx + code=0
业务成功
4xx
参数或兑换码错误
5xx
保留兑换码后补查
安全要求
不要在日志、前端监控、工单或截图中记录 accessToken、sessionToken、银行卡或完整兑换码。生产环境必须使用 HTTPS。