Sharkey/src/docs/api.ja-JP.md

Misskey API

MisskeyAPIを使ってMisskeyクライアント、Misskey連携Webサービス、Bot等(以下「アプリケーション」と呼びます)を開発できます。 ストリーミング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

  • リダイレクト時には、sessionというクエリパラメータでセッションIDが付きます
• permission ... アプリケーションが要求する権限

  • 例: write:notes,write:following,read:drive

  • 要求する権限を,で区切って列挙します
  • どのような権限があるかはAPIリファレンスで確認できます

Step 3

ユーザーが連携を許可した後、{_URL_}/miauth/{session}/checkにPOSTリクエストすると、レスポンスとしてアクセストークンを含むJSONが返ります。

レスポンスに含まれるプロパティ:

• token ... ユーザーのアクセストークン
• user ... ユーザーの情報

「APIの使い方」へ進む

APIの使い方

APIはすべてPOSTで、リクエスト/レスポンスともにJSON形式です。RESTではありません。 アクセストークンは、iというパラメータ名でリクエストに含めます。

• APIリファレンス
• ストリーミングAPI