FIREANIME API
Browse API97 operations
POST

BeginExternalTrackingOAuthConnection

BeginExternalTrackingOAuthConnection starts an OAuth authorization flow.

/api.v1.tracking.ExternalTrackingService/BeginExternalTrackingOAuthConnection Bearer required
01

Request

BeginExternalTrackingOAuthConnectionRequest

BeginExternalTrackingOAuthConnectionRequestapi.v1.tracking.BeginExternalTrackingOAuthConnectionRequest1 fields

Begin External Tracking OAuth Connection Request message.

provider
string

Stable provider key: "anilist" or "mal".

Request JSON
{
  "provider": "string"
}
02

Response

BeginExternalTrackingOAuthConnectionResponse

BeginExternalTrackingOAuthConnectionResponseapi.v1.tracking.BeginExternalTrackingOAuthConnectionResponse3 fields

Begin External Tracking OAuth Connection Response message.

authorizationUrl
string

URL the client should open in a browser to authorize the provider app.

attemptId
string

Opaque identifier used to poll GetExternalTrackingOAuthAttempt.

expiresAt
string

RFC3339 timestamp after which the attempt can no longer be completed.

Example response
{
  "authorizationUrl": "/anime/frieren",
  "attemptId": "string value",
  "expiresAt": "string value"
}
03

Error handling

Common failure codes

unauthenticatedThe Bearer token is missing or invalid.

invalid_argumentThe request payload failed validation.

internalThe service could not complete the operation.