1. 其他应用使用misskey登录
要为使用应用程序的用户(以下简称“用户”)获取访问令牌,请按照以下步骤请求颁发。
提示
下面描述的方法称为 MiAuth,它无需创建应用程序即可立即颁发访问令牌。
步骤 1
生成 UUID。从现在开始,这将被称为会话 ID。
警告
请每次生成此会话ID,并且不要重复使用。
第 2 步
在用户的浏览器中显示应用程序身份验证表单。可以使用以下格式的 URL 打开身份验证表单:
https://{host}/miauth/{session}
- {host}替换为您服务器的主机。主机通常由用户输入。
- {session}替换为您的会话 ID。
您还可以在 URL 中设置一些选项作为查询参数:
姓名 | 解释 |
---|---|
name | 应用程序名称。 |
icon | 应用程序图标图像 URL。 |
callback | 身份验证后重定向到的 URL。 重定向时, session 会话 ID 将作为查询参数添加。 |
permission | 应用程序请求的权限。列出 所请求的权限,以 分隔。您可以在此处 , 检查权限列表。[](https://misskey-hub.net/cn/docs/for-developers/api/permission/) |
例子
https://misskey.example/miauth/c1f6d42b-468b-4fd2-8274-e58abdedef6f?name=MyApp&callback=https%3A%2F%2Fmyapp.example.com%2Fcallback&permission=write:notes,write:following,read:drive
通过之后,携带的参数就是
https://myapp.example.com/callback?session=c1f6d42b-468b-4fd2-8274-e58abdedef6f
步骤3
用户授予应用程序访问权限后,对以下格式的 URL 的 POST 请求将返回包含访问令牌的 JSON 响应。
https://{host}/api/miauth/{session}/check
- {host} 替换为您服务器的主机。
- {session} 替换为您的会话 ID。
响应中包含的属性有:
姓名 | 解释 |
---|---|
token | 用户的访问令牌。 |
user | 用户信息。 |
评论 (0)