用户授权页

按照参数规则配置好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

请求参数

Query 参数

response_type

string

必需

OAuth 授权类型目前仅支持code

示例值:

code

client_id

string

必需

OAuth App Client ID

示例值:

6681463833ebdbb2566d1def

redirect_uri

string

必需

OAuth App 授权完成后的跳转URL，其域名需要和设置的一致，URL路径不需要一致

示例值:

https://wiki.getletbot.com/api/authorize

scope

string

必需

OAuth App 请求的权限需要和您的应用完全一致

示例值:

general_api_access

state

string

可选

可选的OAuth回显参数，会在授权完成后原样回传，方便标记此授权码来自哪个用户

示例值:

EXAMPLE_STATE

redirect_template

string

可选

自定义跳转参数模板(base64)，如果您希望能自定义跳转参数，那么您可以添加此参数

示例值:

P2NvZGU9e2NvZGV9JnN0YXRlPXtzdGF0ZX0mdGdpZD0xMTQ1MTQ=

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

请求参数

示例代码

返回响应