日本語

English
简体中文

日本語

English
简体中文

Markdown ソース

生の markdown をそのまま参照でき、コピー、自動化、AI agent に使えます。

Markdown を表示

Comment API ​

投稿ごとのコメント一覧 ​

prolog
GET API_BASE/comments?post_id=:post_id&offset=:offset&limit=:limit

パラメータ ​

ParameterTypeDescription
post_iduint64Post ID
offsetnumberページネーション offset
limitnumberページネーション limit

レスポンス ​

json
{
  "data": {
    "pagination": {
      "total": 0,
      "offset": 0,
      "next_offset": 20,
      "limit": 20
    },
    "items": [CommentObject, ...]
  },
  "ts": 1723923923
}

コメントを作成する ​

prolog
POST API_BASE/comments

認可要否 ​

OAuthAPIKey
YesYes

リクエストボディ ​

json
{
  "post_id": 1,
  "quote_comment_id": 0,
  "content": "..."
}

レスポンス ​

json
{
  "data": CommentObject,
  "ts": 1723923923
}

コメントを承認する ​

prolog
PUT API_BASE/comments/:comment_id/approve

認可要否 ​

OAuthAPIKey
YesYes

コメントを承認または却下できるのは投稿オーナーのみです。

レスポンス ​

json
{
  "data": null,
  "ts": 1723923923
}

コメントを却下する ​

prolog
PUT API_BASE/comments/:comment_id/reject

認可要否 ​

OAuthAPIKey
YesYes

レスポンス ​

json
{
  "data": null,
  "ts": 1723923923
}

コメントをスパム扱いにする ​

prolog
PUT API_BASE/comments/:comment_id/spam

認可要否 ​

OAuthAPIKey
YesYes

レスポンス ​

json
{
  "data": null,
  "ts": 1723923923
}

コメントを削除する ​

prolog
DELETE API_BASE/comments/:comment_id

認可要否 ​

OAuthAPIKey
YesYes

作者と投稿オーナーはコメントを削除できます。

レスポンス ​

json
{
  "data": null,
  "ts": 1723923923
}