---
title: "批量更新收视进度"
method: POST
path: "/subject/{subject_id}/update/watched_eps"
tags: ["进度"]
deprecated: true
---

# 批量更新收视进度

`POST /subject/{subject_id}/update/watched_eps`

> **Deprecated.**

建议使用 [patchUserSubjectEpisodeCollection](#/%E6%94%B6%E8%97%8F/patchUserSubjectEpisodeCollection)

## Path parameters

- `subject_id` integer, required

## Query parameters

- `watched_eps` string, required
- `watched_vols` string

## Response `200`

成功

- StatusCode — 响应状态（HTTP 状态码都为 200）
  - `request` string — 当前请求的地址
  - `code` 200 | 202 | 304 | 30401 | 400 | 40001 | 401 | 40101 | 40102 | 405 | 404 — 状态码 <br> 200 OK <br> 202 Accepted <br> 304 Not Modified <br> 30401 Not Modified: Collection already exists <br> 400 Bad Request <br> 40001 Error: Nothing found with that ID <br> 401 Unauthorized <br> 40101 Error: Auth failed over 5 times <br> 40102 Error: Username is not an Email address <br> 405 Method Not Allowed <br> 404 Not Found
  - `error` string — 状态信息

## Other responses

- `401` — 未授权

## Changes

- **2022-09-04** `b853f864a527` — 1 info
  - endpoint deprecated
- **2022-04-20** `b563cadc4629` — 1 info
  - api operation id `batchUpdateEpisodeStatusBySubjectId` was added
- **2021-12-28** `6f49623717d8` — 2 info
  - the endpoint scheme security `HTTPBearer` was added to the API
  - the endpoint scheme security `bangumi_auth` was removed from the API
- **2018-02-26** `53c2972105dc` — 5 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 `code` to the response with the `200` status
  - added the optional property `error` to the response with the `200` status
  - …1 more
- **2018-02-23** `eeed42ec5598` — 2 breaking, 1 info
  - added the new required `query` request parameter `watched_eps`
  - removed the request body
  - added the new optional `query` request parameter `watched_vols`

[Full history](https://skmtc.dev/bangumi/apis/bangumi-api/changes/subject/:subject_id/update/watched_eps/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/890913d92c65?raw)