#Misskey API リファレンス(Unofficial)
##最初に
このAPIリファレンスは非公式だし、書きかけです。
使用する際には自己責任でお願いします。
あとAPIがちゃんと使えるかどうかは確認してません。
Authorizeを除いてパラメータは必須と書いていない物以外はすべて任意です
##参考までに
- https://misskey.xyz/mrhc/status/55d43b3a8c2686d97a831081
- https://misskey.xyz/mrhc/status/55d5f61555b181d061729536 ##Authorize
- http://dev.misskey.xyz/ からapp-keyを入手する
- https://api.misskey.xyz/sauth/get-authentication-session-key にGETリクエストを送る
- ヘッダー
- sauth-app-key:あなたのapp-key
- レスポンス
- JSON
- このうち使うのはauthenticationSessionKey
- https://api.misskey.xyz/authorize@先程のauthenticationSessionKey をブラウザで開かせる
- PINコードを入手する
- callback urlを指定している場合はGETパラメータのpin-codeにやってくる
- https://api.misskey.xyz/sauth/get-user-key にGETリクエストを送る
- ヘッダー
- sauth-app-key:あなたのapp-key
- パラメータ
- pin-code:PINコード
- authentication-session-key:先程のauthenticationSessionKey
- レスポンス
- JSON
- このうち使うのはuserKeyのみ
- JSON
あとはヘッダーに
- sauth-app-keyにあなたのapp-key
- sauth-user-keyに先程のuserKey
を含めてリクエストするだけ
##status
- GET status/timeline
- タイムラインを取得
- パラメータ
- since-cursor
- max-cursor
- count
- レスポンス
- ステータスオブジェクトの配列
- POST status/update
- 投稿する
- パラメータ
- text(必須)
- レスポンス
- ステータスオブジェクト
- POST status/repost
- RePostする
- パラメータ
- status-id(必須)
- text
- レスポンス
- 恐らくステータスオブジェクト?
- 参考までに
- 指定されたstatus-idがRePostだったらRePost元をRePostするっぽいので心配は無用?
- POST status/favorite
- ふぁぼる
- パラメータ
- status-id(必須)
- レスポンス
- 恐らくない?
- 参考までに
- すでにふぁぼっているとHTTPステータスコード400のエラーが返ってくるので注意
- GET status/show
- 指定したステータスを取得
- パラメータ
- status-id(必須)
- レスポンス
- ステータスオブジェクト
##users
- GET users/show
- ユーザー情報を取得
- パラメータ
- user-id(必須)
- レスポンス
- ユーザーオブジェクト
- POST users/follow
- フォローする
- パラメータ
- user-id(必須)
- レスポンス
- 恐らくユーザーオブジェクト
- DELETE users/unfollow
- リムる
- パラメータ
- user-id(必須)
- レスポンス
- 恐らくユーザーオブジェクト
##notice
- POST notice/create
- 通知を作成する
- パラメータ
- text
- レスポンス
- 通知オブジェクト
- 参考までに
- レートリミットが設定されているようだ。100リクエスト/86400秒?
- 通知タイプはapplication固定
- GET notice/timeline
- 通知一覧を取得する
- パラメータ
- since-cursor
- max-cursor
- count
- レスポンス
- 通知オブジェクトの配列
- DELETE notice/delete
- 指定された通知1件を削除する
- パラメータ
- notice-id(必須)
- レスポンス
- status
- success
- status
- DELETE notice/delete-all
- 通知全てを削除する
- レスポンス
- status
- success
- status
Awesome