---
title: "获取当前用户的角色收藏"
method: GET
path: "/p1/collections/characters"
tags: ["collection"]
---

# 获取当前用户的角色收藏

`GET /p1/collections/characters`

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Default Response

- object
  - `data` Character[], required
    - `collectedAt` integer
    - `collects` integer, required
    - `comment` integer, required
    - `id` integer, required
    - `images` PersonImages
      - `grid` string, required
      - `large` string, required
      - `medium` string, required
      - `small` string, required
    - `info` string, required
    - `infobox` object[], required
      - `key` string, required
      - `values` object[], required
        - `k` string
        - `v` string, required
    - `lock` boolean, required
    - `name` string, required
    - `nameCN` string, required
    - `nsfw` boolean, required
    - `redirect` integer, required
    - `role` 1 | 2 | 3 | 4, required — 角色类型 - 1 = 角色 - 2 = 机体 - 3 = 舰船 - 4 = 组织机构
    - `summary` string, required
  - `total` integer, required — limit+offset 为参数的请求表示总条数，page 为参数的请求表示总页数

## Other responses

- `500` — 意料之外的服务器错误

---

[API](https://skmtc.net/bangumi/apis/bangumi-private-api.md) · [All operations](https://skmtc.net/bangumi/apis/bangumi-private-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bangumi/bangumi-private-api/versions/79dbcbd374a3/schema)