documentation/methods.md at 283f0c7c573c9d3b38fda0d026fbf6943ff9a619

2.4 KiB

Raw Blame History

title: "{{ replace .Name "-" " " | title }}" description: menu: docs: parent: methods

What the method does

GET https://mastodon.example/api/v1/example HTTP/1.1

Returns: [SOMETHING]({{< relref "entities/SOMETHING" >}})
OAuth: User token + oauth:scope
Permissions: Manage ???
Version history:
x.x.x - added

Request

Path parameters

:id: {{}} String. The ID of the SOMETHING in the database.

Headers

Authorization: {{}} Provide this header with Bearer <user token> to gain authorized access to this API method.

Query parameters

Internal parameter. Use HTTP Link header for pagination.

max_id: String. Return results older than ID.
since_id: String. Return results newer than ID.
min_id: String. Return results immediately newer than ID.
limit: Integer. Maximum number of results to return. Defaults to 20. Max 40.

Form data parameters

Response

200: OK

Because SOMETHING IDs are generally not exposed via any API responses, you will have to parse the HTTP Link header to load older or newer results. See [Paginating through API responses]({{<relref "api/guidelines#pagination">}}) for more information.

Link:

401: Unauthorized

Invalid or missing Authorization header.

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

403: Forbidden

Authorized user is missing a permission, or invalid or missing Authorization header

{
  "error": "This action is not allowed"
}

404: Not found

SOMETHING is not owned by you or does not exist

{
  "error": "Record not found"
}

410: Gone

422: Unprocessable entity

429: Rate limited

{
  "error": "Too many requests"
}

503: Service unavailable

{
  "error": "There was a temporary problem serving your request, please try again"
}

2.4 KiB Raw Blame History