質問

質問の送信・受信・回答・削除を行うエンドポイントです。

POST/api/v1/questions

ユーザーに質問を送信します。API キーで認証している場合、CAPTCHA は不要です。

認証

認証不要。CAPTCHA をスキップするには API キーを推奨。

リクエストボディ

{
  "recipientId": "user-id-string",
  "content": "Hello! (max 2000 chars)",
  "isAnonymous": true
}

GET/api/v1/questions/:id

ID で単一の質問を取得します。

認証

認証不要(公開エンドポイント)

GET/api/v1/questions/inbox

認証済みユーザーが受信した質問一覧を取得します。

認証

questions:read

クエリパラメータ

パラメータ	型	説明
page	number	ページ番号(デフォルト: 1)
limit	number	ページごとの件数(デフォルト: 20、最大: 50)

GET/api/v1/questions/sent

認証済みユーザーが送信した質問一覧を取得します。

認証

questions:read

クエリパラメータ

パラメータ	型	説明
page	number	ページ番号(デフォルト: 1)
limit	number	ページごとの件数(デフォルト: 20、最大: 50)

GET/api/v1/questions/user/:handle

ユーザーの公開ページ用の回答済み質問一覧を取得します。

認証

認証不要(公開エンドポイント)

パスパラメータ

パラメータ	説明
handle	@user@instance.example 形式のユーザーハンドル

クエリパラメータ

パラメータ	型	説明
cursor	string	前のレスポンスからのページネーションカーソル(質問 ID)
limit	number	ページごとの件数(デフォルト: 20、最大: 50)

POST/api/v1/questions/:id/answer

質問に回答を送信します。受信者のみ回答できます。

認証

questions:write

リクエストボディ

{
  "answer": "My answer text (max 3000 chars)",
  "requireLoginToView": false,
  "postToMisskey": false,      // optional: also post to Misskey
  "noteVisibility": "public",  // public, home, followers
  "useCW": false,              // content warning
}

POST/api/v1/questions/:id/delete

質問を削除します。受信者のみ削除できます。

認証

questions:write