---
title: "获取角色关联角色"
method: GET
path: "/p1/characters/{characterID}/relations"
tags: ["character"]
---

# 获取角色关联角色

`GET /p1/characters/{characterID}/relations`

## Path parameters

- `characterID` integer, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Default Response

- object
  - `data` CharacterRelation[], required
    - `character` SlimCharacter, required
      - `comment` integer, required
      - `id` integer, required
      - `images` PersonImages
        - `grid` string, required
        - `large` string, required
        - `medium` string, required
        - `small` string, required
      - `info` string, required
      - `lock` boolean, required
      - `name` string, required
      - `nameCN` string, required
      - `nsfw` boolean, required
      - `role` integer, required
    - `comment` string, required
    - `ended` boolean, required
    - `relation` PersonRelationType, required
      - `cn` string, required
      - `desc` string, required
      - `id` integer, required
      - `primary` boolean
      - `skipViceVersa` boolean
      - `viceVersaTo` integer
    - `spoiler` boolean, required
  - `total` integer, required — limit+offset 为参数的请求表示总条数，page 为参数的请求表示总页数

## Other responses

- `404` — default error response type
- `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/revisions/79dbcbd374a3/schema)