paricafe/src/docs/zh-CN/api.md

Misskey API

您可以使用Misskey API来开发Misskey客户端、与Misskey链接的Web服务、Bot等应用（以下称为“应用程序”）。 另外还有一个流式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参考中确认您所拥有的权限。

Step 3

用户允许发行后，对{_URL_}/api/miauth/{session}/check的POST请求所返回的是一个包含访问令牌的JSON格式的响应。

响应中包含的属性：

• token ... 用户的访问令牌
• user ... 用户信息

转到“API使用方法”

API使用方法

所有API均为POST，并且请求/响应均为JSON格式。不是REST。 访问令牌包含在请求中，参数名为i。

• API 参考
• 流式API