---
title: "添加收藏"
method: POST
path: "/collection/{subject_id}/create"
tags: ["收藏"]
---

# 添加收藏

`POST /collection/{subject_id}/create`

## Path parameters

- `subject_id` integer, required

## Response `200`

条目收藏信息

- object
  - `status` CollectionStatus — 收藏状态 <br> 1 = wish = 想做 <br> 2 = collect = 做过 <br> 3 = do = 在做 <br> 4 = on_hold = 搁置 <br> 5 = dropped = 抛弃
    - `id` 1 | 2 | 3 | 4 | 5 — 收藏状态 ID
    - `type` 'wish' | 'collect' | 'do' | 'on_hold' | 'dropped' — 收藏状态类型
    - `name` '想做' | '做过' | '在做' | '搁置' | '抛弃' — 收藏状态名称
  - `rating` integer — 评分
  - `comment` string — 评论
  - `private` 0 | 1 — 收藏隐私
  - `tag` string[] — 标签
  - `ep_status` integer — 完成话数
  - `lasttouch` integer — 上次更新时间
  - `user` User — 用户信息
    - `id` integer — 用户 id
    - `url` string — 用户主页地址
    - `username` string — 用户名
    - `nickname` string — 昵称
    - `avatar` object — 头像地址
      - `large` string
      - `medium` string
      - `small` string
    - `sign` string — 签名

## Other responses

- `401` — 未授权

## Changes

- **2018-02-26** `53c2972105dc` — 10 info
  - the endpoint scheme security `bangumi_auth` was added to the API
  - added the non-success response with the status `401`
  - added the optional property `comment` to the response with the `200` status
  - added the optional property `ep_status` to the response with the `200` status
  - …6 more
- **2018-02-23** `8478404cd363` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/bangumi/apis/bangumi-api/changes/collection/:subject_id/create/post.md)

---

[API](https://skmtc.dev/bangumi/apis/bangumi-api.md) · [All operations](https://skmtc.dev/bangumi/apis/bangumi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bangumi/apis/bangumi-api/revisions/53c2972105dc?raw)