conversations

Direct conversations with other participants. (Currently, just threads containing a post with "direct" visibility.)

get
Show conversation

https://mastodon.example/api/v1/conversations

戻り値: Array of Conversation
OAuth: User token + read:statuses
実装履歴:

  • 2.6.0 - 追加

リクエスト

ヘッダ
Authorization
必須
string
Bearer <user token>
クエリ
limit
任意
string
Maximum number of results. Defaults to 20. Max 40.
max_id
任意
string
Return results older than this ID. Use HTTP Link header to paginate.
since_id
任意
string
Return results newer than this ID. Use HTTP Link header to paginate.
min_id
任意
string
Return results immediately newer than this ID. Use HTTP Link header to paginate.

レスポンス

200: Success

Truncated sample results of an API call with limit=2 

[
  {
    "id": "418450",
    "unread": true,
    "accounts": [
      {
        "id": "482403",
        "username": "amic",
        "acct": "amic@nulled.red",
        ...
      }
    ],
    "last_status": {
      "id": "103196583826321184",
      "created_at": "2019-11-25T04:08:24.000Z",
      "in_reply_to_id": "103196540587943467",
      "in_reply_to_account_id": "14715",
      ...
    }
  },
  {
    "id": "418374",
    "unread": false,
    "accounts": [
      {
        "id": "464472",
        "username": "freon",
        "acct": "freon@letsalllovela.in",
        ...
      }
    ],
    "last_status": {
      "id": "103195253010396431",
      "created_at": "2019-11-24T22:29:56.331Z",
      "in_reply_to_id": "103195239650546339",
      "in_reply_to_account_id": "14715",
      ...
    }
  }
]

401: Unauthorized

Invalid or missing Authorization header 

{
  "error": "The access token is invalid"
}

delete
Remove conversation

https://mastodon.example/api/v1/conversations/:id

戻り値: empty object
OAuth: User token + write:conversations
実装履歴:

  • 2.6.0 - 追加

リクエスト

パス
:id
必須
string
ID of the conversation in the database
ヘッダ
Authorization
必須
string

レスポンス

200: Success

An empty object will be returned. 

{}

401: Unauthorized

Invalid or missing Authentication header 

{
  "error": "The access token is invalid"
}

404: Not Found

The conversation does not exist, or is not owned by you. 

{
  "error": "Record not found"
}

post
Mark as read

https://mastodon.example/api/v1/conversations/:id/read

戻り値: Conversation
OAuth: User token + write:conversations
実装履歴:

  • 2.6.0 - 追加

リクエスト

パス
:id
任意
string
ID of the conversation in the database
ヘッダ
Authorization
必須
string

レスポンス

200: Success

The value of unread has been changed to false. 

{
  "id": "418450",
  "unread": false,
  "accounts": [
    {
      "id": "482403",
      ...
    }
  ],
  "last_status": {
    "id": "103196583826321184",
    ...
  }
}

401: Unauthorized

Invalid or missing Authorization header 

{
  "error": "The access token is invalid"
}

404: Not Found

The conversation does not exist, or is not owned by you. 

{
  "error": "Record not found"
}

最終更新 May 17, 2020 · このページを改善する
他の言語: English