milmilmilmil
API 參考

Collection

User's anime collection: watch status, recents, status counts

GET
/api/v1/collection

Authorization

bearerAuth
AuthorizationBearer <token>

Pass an API token obtained from POST /api/v1/auth/login or POST /api/v1/api-tokens. Tokens have the prefix mlml_.

In: header

Query Parameters

status?string

Value in

  • "watching"
  • "completed"
  • "on_hold"
  • "dropped"
  • "plan_to_watch"
search?string
sort?string

Response Body

application/json

curl -X GET "https://example.com/api/v1/collection"
[  {    "bangumi_id": 0,    "status": "watching",    "score": 0,    "anime": {      "bangumi_id": 0,      "anilist_id": 0,      "title": "string",      "title_original": "string",      "title_en": "string",      "cover_image": "string",      "air_date": "string",      "episode_count": 0,      "score": 0    },    "updated_at": "string"  }]
GET
/api/v1/collection/recent

Authorization

bearerAuth
AuthorizationBearer <token>

Pass an API token obtained from POST /api/v1/auth/login or POST /api/v1/api-tokens. Tokens have the prefix mlml_.

In: header

Response Body

application/json

curl -X GET "https://example.com/api/v1/collection/recent"
[  {    "bangumi_id": 0,    "status": "watching",    "score": 0,    "anime": {      "bangumi_id": 0,      "anilist_id": 0,      "title": "string",      "title_original": "string",      "title_en": "string",      "cover_image": "string",      "air_date": "string",      "episode_count": 0,      "score": 0    },    "updated_at": "string"  }]
GET
/api/v1/collection/status-counts

Authorization

bearerAuth
AuthorizationBearer <token>

Pass an API token obtained from POST /api/v1/auth/login or POST /api/v1/api-tokens. Tokens have the prefix mlml_.

In: header

Response Body

application/json

curl -X GET "https://example.com/api/v1/collection/status-counts"
{  "watching": 0,  "completed": 0,  "on_hold": 0,  "dropped": 0,  "plan_to_watch": 0}
PATCH
/api/v1/collection/{bangumiId}/status

Authorization

bearerAuth
AuthorizationBearer <token>

Pass an API token obtained from POST /api/v1/auth/login or POST /api/v1/api-tokens. Tokens have the prefix mlml_.

In: header

Path Parameters

bangumiId*integer

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

curl -X PATCH "https://example.com/api/v1/collection/0/status" \  -H "Content-Type: application/json" \  -d '{    "status": "watching"  }'
Empty