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.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)