follow_requests

View and manage follow requests.

get
Pending Follows

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

戻り値: Array of Account
OAuth: User token + read:follows or follow
実装履歴:

  • 0.0.0 - 追加

リクエスト

ヘッダ
Authorization
必須
string
Bearer <user token>
クエリ
limit
任意
string
Maximum number of results to return. Defaults to 40. Paginate using the HTTP Link header.

レスポンス

200: Success

Accounts that are requesting a follow 

Link: <https://mastodon.social/api/v1/follow_requests?max_id=23716836>; rel="next", <https://mastodon.social/api/v1/follow_requests?min_id=23716978>; rel="prev"

[
  {
    "id": "8889777",
    "username": "example",
    "acct": "example@social.example",
    ...
  }
]

401: Unauthorized

Invalid or missing Authorization header 

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

post
Accept Follow

https://mastodon.example/api/v1/follow_requests/:id/authorize

戻り値: Relationship
OAuth: User token + write:follows or follow
実装履歴:

  • 0.0.0 - 追加
  • 3.0.0 - now returns Relationship instead of nothing

リクエスト

パス
:id
任意
string
ID of the account in the database
ヘッダ
Authorization
必須
string
Bearer <user token>

レスポンス

200: Success

Your Relationship with this account should be updated so that you are followed_by this account. 

{
  "id": "8889777",
  "following": false,
  "showing_reblogs": false,
  "followed_by": true,
  "blocking": false,
  "blocked_by": false,
  "muting": false,
  "muting_notifications": false,
  "requested": false,
  "domain_blocking": false,
  "endorsed": false
}

401: Unauthorized

Invalid or missing Authorization header 

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

404: Not Found

No pending follow request from that user ID 

{
  "error": "Record not found"
}

post
Reject Follow

https://mastodon.example/api/v1/follow_requests/:id/reject

戻り値: Relationship
OAuth: User token + write:follows or follow
実装履歴:

  • 0.0.0 - 追加
  • 3.0.0 - now returns Relationship instead of nothing

リクエスト

パス
:id
任意
string
ID of the account in the database
ヘッダ
Authorization
必須
string
Bearer <user token>

レスポンス

200: Success

Your Relationship with this Account should be unchanged. 

{
  "id": "8889777",
  "following": false,
  "showing_reblogs": false,
  "followed_by": false,
  "blocking": false,
  "blocked_by": false,
  "muting": false,
  "muting_notifications": false,
  "requested": false,
  "domain_blocking": false,
  "endorsed": false
}

401: Unauthorized

Invalid or missing Authorization header 

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

404: Not Found

No pending follow request for that user ID 

{
  "error": "Record not found"
}

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