From 0d10ca02dbc5cde068eb702ee8097226faa314e3 Mon Sep 17 00:00:00 2001 From: syuilo Date: Thu, 12 Aug 2021 12:48:24 +0900 Subject: New Crowdin updates (#7619) * New translations disable-timelines.md (Chinese Simplified) * New translations api.md (Chinese Simplified) * New translations api.md (Chinese Simplified) * New translations ja-JP.yml (Chinese Simplified) * New translations api.md (Chinese Simplified) * New translations api.md (Chinese Simplified) * New translations api.md (Chinese Simplified) * New translations create-plugin.md (Chinese Simplified) * New translations stream.md (Chinese Simplified) * New translations ja-JP.yml (German) * New translations ja-JP.yml (English) * New translations note.md (English) * New translations links.md (English) * New translations ja-JP.yml (Korean) * New translations ja-JP.yml (Russian) * New translations troubleshooting.md (Russian) * New translations ja-JP.yml (Russian) * New translations ja-JP.yml (English) * New translations ja-JP.yml (Chinese Simplified) --- src/docs/zh-CN/advanced/api.md | 68 +++++++++++++++++++++--------------------- 1 file changed, 34 insertions(+), 34 deletions(-) (limited to 'src/docs/zh-CN/advanced/api.md') diff --git a/src/docs/zh-CN/advanced/api.md b/src/docs/zh-CN/advanced/api.md index 76019b6145..a1ca2f470b 100644 --- a/src/docs/zh-CN/advanced/api.md +++ b/src/docs/zh-CN/advanced/api.md @@ -1,58 +1,58 @@ # Misskey API -MisskeyAPIを使ってMisskeyクライアント、Misskey連携Webサービス、Bot等(以下「アプリケーション」と呼びます)を開発できます。 ストリーミングAPIもあるので、リアルタイム性のあるアプリケーションを作ることも可能です。 +您可以使用Misskey API来开发Misskey客户端、与Misskey链接的Web服务、Bot等应用（以下称为“应用程序”）。 另外还有一个流式API，因此还可以用来创建实时性的应用程序。 -APIを使い始めるには、まずアクセストークンを取得する必要があります。 このドキュメントでは、アクセストークンを取得する手順を説明した後、基本的なAPIの使い方を説明します。 +开始使用API前​​，您首先需要获取访问令牌。 本文档将向您介绍获取访问令牌所需的步骤，以及API的基本使用方法。 -## アクセストークンの取得 -基本的に、APIはリクエストにはアクセストークンが必要となります。 APIにリクエストするのが自分自身なのか、不特定の利用者に使ってもらうアプリケーションなのかによって取得手順は異なります。 +## 访问令牌的获取 +总的来说，API请求需要访问令牌。 获取方式则根据请求的API或者非特定用户所使用的应用程序而有所不同。 -* 前者の場合: [「自分自身のアクセストークンを手動発行する」](#自分自身のアクセストークンを手動発行する)に進む -* 後者の場合: [「アプリケーション利用者にアクセストークンの発行をリクエストする」](#アプリケーション利用者にアクセストークンの発行をリクエストする)に進む +* 对于前者：请转到[“手动发放自己的访问令牌”](#自分自身のアクセストークンを手動発行する) +* 对于后者：请转到[“请求应用程序用户发放访问令牌”](#アプリケーション利用者にアクセストークンの発行をリクエストする) -### 自分自身のアクセストークンを手動発行する -「設定 > API」で、自分のアクセストークンを発行できます。 +### 手动发放自己的访问令牌 +您可以在“设置 > API”中发放自己的访问令牌。 -[「APIの使い方」へ進む](#APIの使い方) +[请转到“API使用方法”](#APIの使い方) -### アプリケーション利用者にアクセストークンの発行をリクエストする -アプリケーション利用者のアクセストークンを取得するには、以下の手順で発行をリクエストします。 +### 请求应用程序用户发放访问令牌 +要获取应用程序用户的访问令牌，请按照以下步骤请求发放。 -#### Step 1 +#### 步骤 1 -UUIDを生成する。以後これをセッションIDと呼びます。 +生成UUID。以下将其称为会话ID。 -> このセッションIDは毎回生成し、使いまわさないようにしてください。 +> 此会话ID需要每次重新生成，请勿重复使用。 -#### Step 2 +#### 步骤 2 -`{_URL_}/miauth/{session}`をユーザーのブラウザで表示させる。`{session}`の部分は、セッションIDに置き換えてください。 +在用户的浏览器中显示`{_URL_}/miauth/{session}`。将`{session}`的部分替换为会话ID。 > 例: `{_URL_}/miauth/c1f6d42b-468b-4fd2-8274-e58abdedef6f` -表示する際、URLにクエリパラメータとしていくつかのオプションを設定できます: -* `name` ... アプリケーション名 +显示时，可以在URL中设置一些选项作为查询参数： +* `name` ... 应用程序名称 * > 例: `MissDeck` -* `icon` ... アプリケーションのアイコン画像URL +* `icon` ... 应用程序图标URL * > 例: `https://missdeck.example.com/icon.png` -* `callback` ... 認証が終わった後にリダイレクトするURL +* `callback` ... 认证后重定向的URL * > 例: `https://missdeck.example.com/callback` - * リダイレクト時には、`session`というクエリパラメータでセッションIDが付きます -* `permission` ... アプリケーションが要求する権限 + * 重定向时，会话ID将添加查询参数`session` +* `permission` ... 应用程序要求的权限 * > 例: `write:notes,write:following,read:drive` - * 要求する権限を`,`で区切って列挙します - * どのような権限があるかは[APIリファレンス](/api-doc)で確認できます + * 要求的权限需要以`,`分隔 + * 您可以在[API参考](/api-doc)中确认您所拥有的权限。 -#### Step 3 -ユーザーが発行を許可した後、`{_URL_}/api/miauth/{session}/check`にPOSTリクエストすると、レスポンスとしてアクセストークンを含むJSONが返ります。 +#### 步骤 3 +用户允许发行后，对`{_URL_}/api/miauth/{session}/check`的POST请求所返回的是一个包含访问令牌的JSON格式的响应。 -レスポンスに含まれるプロパティ: -* `token` ... ユーザーのアクセストークン -* `user` ... ユーザーの情報 +响应中包含的属性： +* `token` ... 用户的访问令牌 +* `user` ... 用户信息 -[「APIの使い方」へ進む](#APIの使い方) +[请转到“API使用方法”](#APIの使い方) -## APIの使い方 -**APIはすべてPOSTで、リクエスト/レスポンスともにJSON形式です。RESTではありません。** アクセストークンは、`i`というパラメータ名でリクエストに含めます。 +## API使用方法 +**所有API均为POST，并且请求/响应均为JSON格式。不是REST。** 访问令牌包含在请求中，参数名为`i`。 -* [APIリファレンス](/api-doc) -* [ストリーミングAPI](./stream) +* [API 参考](/api-doc) +* [流式API](./stream) -- cgit v1.2.3-freya