blob: 4a67622e3053d4d17fc94f8410efb6f9b75eefb3 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
|
# Misskey API
您可以使用Misskey API来开发Misskey客户端、与Misskey链接的Web服务、Bot等应用（以下称为“应用程序”）。 另外还有一个流式API，因此还可以用来创建实时性的应用程序。
开始使用API前，您首先需要获取访问令牌。 本文档将引导您完成获取访问令牌的步骤，然后介绍API的基本使用方法。
## 访问令牌的获取
总的来说，API请求需要访问令牌。 获取方式则根据请求的API或者非特定用户所使用的应用程序而有所不同。
* 对于前者：转到[“手动发放自己的访问令牌”](#自分自身のアクセストークンを手動発行する)
* 对于后者：转到[“请求应用程序用户发放访问令牌”](#アプリケーション利用者にアクセストークンの発行をリクエストする)
### 手动发放自己的访问令牌
您可以在“设置 > API”中发放自己的访问令牌。
[转到“API使用方法”](#APIの使い方)
### 请求应用程序用户发放访问令牌
要获取应用程序用户的访问令牌，请按照以下步骤请求发放。
#### Step 1
生成UUID。以下将其称为会话ID。
> 此会话ID需要每次重新生成，请勿重复使用。
#### Step 2
在用户的浏览器中显示`{_URL_}/miauth/{session}`。将`{session}`的部分替换为会话ID。
> 例: `{_URL_}/miauth/c1f6d42b-468b-4fd2-8274-e58abdedef6f`
显示时，可以在URL中设置一些选项作为查询参数：
* `name` ... 应用程序名称
* > 例: `MissDeck`
* `icon` ... 应用程序图标URL
* > 例: `https://missdeck.example.com/icon.png`
* `callback` ... 认证后重定向的URL
* > 例: `https://missdeck.example.com/callback`
* 重定向时，会话ID将添加查询参数`session`
* `permission` ... 应用程序要求的权限
* > 例: `write:notes,write:following,read:drive`
* 要求的权限需要以`,`分隔
* 您可以在[API参考](/api-doc)中确认您所拥有的权限。
#### Step 3
用户允许发行后，对`{_URL_}/api/miauth/{session}/check`的POST请求所返回的是一个包含访问令牌的JSON格式的响应。
响应中包含的属性：
* `token` ... 用户的访问令牌
* `user` ... 用户信息
[转到“API使用方法”](#APIの使い方)
## API使用方法
**所有API均为POST，并且请求/响应均为JSON格式。不是REST。** 访问令牌包含在请求中，参数名为`i`。
* [API 参考](/api-doc)
* [流式API](./stream)
|
