用户授权页
GET
https://next.ohmygpt.com/next/v1/oauth按照参数规则配置好URL,并让用户在浏览器中打开此URL,从而要求用户授权您的应用,授权完成后将会获得Code并重定向到带参数的redirect_uri
中
示例URL1:
https://next.aigptx.top/next/v1/oauth?response_type=code&client_id=6681463833ebdbb2566d1def&redirect_uri=https://next.aigptx.top/next/v1/oauth/succeed&scope=general_api_access&state=EXAMPLE_STATE
授权后将会重定向到:
https://next.aigptx.top/next/v1/oauth/succeed?code=gtsi4Ww0ADHKwqZi&state=EXAMPLE_STATE
效果图:
示例URL2:
https://next.aigptx.top/next/v1/oauth?response_type=code&client_id=6681463833ebdbb2566d1def&redirect_uri=https://wiki.getletbot.com/api/authorize&scope=general_api_access&state=EXAMPLE_STATE
授权后,将会跳转到:
https://wiki.getletbot.com/api/authorize?code=rA6HSC0xLXbV1lJj&state=EXAMPLE_STATE
作为开发者,您可以选择一下任意一种方式进行下一步流程:
- 实现此GET接口,拿到
code
等参数以进一步完成OAuth授权流程 - 让用户重定向到网站的
/next/v1/oauth/succeed
中,此页面可展示Code,并提示用户在您的应用中输入此Code
注:为照顾部分地区的用户,此处URL前缀也可以替换为:
https://next.aigptx.top/next/v1/oauth
关于redirect_template参数:
可自定义一个模板,从而实现更大自由度的跳转URL参数实现:
例如:?code={code}&state={state}&tgid=114514
转换为base64为:P2NvZGU9e2NvZGV9JnN0YXRlPXtzdGF0ZX0mdGdpZD0xMTQ1MTQ=
授权成功后则会自动替换{code}
和{state}
为对应的参数,然后直接在前面拼接上redirect_uri执行跳转
附:base64转换小工具: https://it-tools.dogenet.win/base64-string-converter
请求参数
OAuth 授权类型 目前仅支持code
OAuth App Client ID
OAuth App 授权完成后的跳转URL,其域名需要和设置的一致,URL路径不需要一致
OAuth App 请求的权限 需要和您的应用完全一致
可选的OAuth回显参数,会在授权完成后原样回传,方便标记此授权码来自哪个用户
自定义跳转参数模板(base64),如果您希望能自定义跳转参数,那么您可以添加此参数
示例代码
返回响应
{}