申请access_token
POST
/api/v1/user/oauth/issue-tokenOAuth APP服务端通过自己的client_id+client_secret以及从用户那里拿到的code请求OAuth Access Token
拿到用户的OAuth Token后,即可调用各种开放API以访问用户授权的资源
但需要注意处理OAuth Token被撤销的情况
用户可以随时撤销对您的OAuth App的授权,此时会返回4xx错误+如下格式的响应:
{
"statusCode": 401,
"message": "Incorrect OhMyGPT OAuth token provided. Please try to re-authenticate with the OAuth provider.",
"errorType": "oauth_invalid_token_error",
"data": null
}
只要发现 errorType
为 oauth_invalid_token_error
即证明此Token无效,可丢弃此Token并要求用户重新授权
如果遇到余额不足的错误:
{
"statusCode": 402,
"message": "User balance is insufficient, your request has been rejected, please recharge in time at https://www.ohmygpt.com/pay .",
"errorType": "insufficient_balance_error",
"data": null
}
以上报错表示用户余额不足,此时该用户大部分的API调用权限将被限制,建议提示用户前往网站进行充值以解除限制
请求参数
Body 参数application/x-www-form-urlencoded
client_id
string
可选
OA APP的client_id
示例值:
6680e0785ffd0e948c705db7
client_secret
string
可选
OA APP的client_secret
示例值:
TREAHK4hnqEmST4YjD8Ki8338HyrmEDc
code
string
可选
OA APP从用户那边拿到的授权码
示例值:
code
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
object {0}
示例
成功示例
{
"statusCode": 200,
"message": "Issue OAuth Token success",
"data": {
"user_id": "888",
"client_id": "6681463833ebdbb2566d1def",
"token": "omg-oat-v1-VVfxxxx4BG6xaxxxxrnS"
}
}
最后修改时间: 4 个月前