文档 moyu 补丁listPatches

listPatches

列出或反查补丁页

Without `ids` or `refs` this is the whole collection, paged and sorted. With either, it is a **batch lookup**: up to 100 anchors in one request, with every anchor that matched nothing echoed back in `missing`. This is how you ask "which of these 100 games do you have patches for" in one round trip. A batch answers a set, not a page, so `cursor` and `sort` are refused alongside it. Note that two pages can name one catalog work — moyu dedupes on the VNDB string and a game that arrived under two spellings has two pages — so `refs=catalog:<id>` may answer more than one item. They are ordered so that the page a reader should land on comes first.

get/v2/moyu/patches

Authorization: Bearer nmk_live_…（任意有效 v2 应用密钥即可,无需任何 scope;唯一例外是 /v2/moyu/resources/{id}/file,要运营发放的 moyu:files）

参数

参数	类型	位置	说明
`limit`	`integer`	`query`	1 到 100。超过 100 是 `LIMIT_TOO_LARGE`，不会被夹到上限。
`cursor`	`string`	`query`	同一个集合上一页返回的 `next_cursor`。
`include_total`	`boolean`	`query`	统计整个集合的条数。默认不带，因为它要花一次 count。
`nsfw`	`boolean`	`query`	Include pages catalog rates as adult. Off by default, matching catalog's own convention; a page catalog has not been rated yet is included either way and reports `content_limit: null`.
`include`	`string[]`	`query`	要附加的关系，逗号分隔。 `resourcespublisher`
`ids`	`string[]`	`query`	Up to 100 moyu patch ids. Mutually exclusive with `refs`.
`refs`	`string[]`	`query`	Up to 100 foreign anchors as `source:external_id`. Sources are `vndb` (a VNDB id such as `v65869`) and `catalog` (a NextMoe catalog work id). Mutually exclusive with `ids`.
`sort`	`string`	`query`	All descending. `updated` orders by when a resource was last added or changed, which is not the same as when the page was edited. `updatedcreateddownloadsviews`
`type`	`string[]`	`query`	补丁类型，逗号分隔；命中其中任意一个即可。 `manualaimachine_polishingmachinesavecrackfixmodr18decensorimageother`
`language`	`string[]`	`query`	语言，逗号分隔；命中其中任意一个即可。 `zh-Hanszh-Hantjaenother`
`platform`	`string[]`	`query`	平台，逗号分隔；命中其中任意一个即可。 `windowsandroidmacosioslinuxother`
`has_resources`	`boolean`	`query`	Unset returns every page. A page can exist with no resources on it yet; `true` is the filter for "actually has something to download".

响应

objectstring 必填
itemsobject[] 必填
- objectstring 必填
- idstring 必填
- vndb_idstring 必填
  moyu's own dedupe key. Usually a VNDB id, but a page created before its game reached VNDB carries a placeholder instead.
- catalog_work_idstring 必填可空
  The NextMoe catalog work this page is about, for `/v2/catalog/works`. Null on the placeholder pages that have no work yet.
- content_limitstring 必填可空
  Catalog's display verdict, mirrored. Null means moyu has not mirrored it yet; catalog is the authority either way.
  枚举sfwnsfw
- release_datestringdate 必填可空
- typestring[] 必填
  该页上的资源属于哪些补丁类型。
- languagestring[] 必填
- platformstring[] 必填
- resource_countinteger 必填
- download_countinteger 必填
- view_countinteger 必填
- favorite_countinteger 必填
- comment_countinteger 必填
- web_urlstringuri 必填
  moyu 上的页面。读者去下载的地方。
- created_atstringdate-time 必填
- updated_atstringdate-time 必填
- resource_updated_atstringdate-time 必填
  资源最近一次新增或改动的时间。
- publisherobject
  Who published it. The profile itself belongs to the NextMoe identity service; this is a display copy.
- resourcesobject[]
  仅当 `include=resources` 时出现。
next_cursorstring 必填可空
取下一页时作为 `cursor` 传回。末页为 null。
totalinteger 必填可空
除非 `include_total=true`，否则为 null。
missingstring[]
Only on the `ids`/`refs` lane. The anchors that matched nothing, in the spelling you sent.

请求示例

cURL

curl "https://api.nextmoe.dev/v2/moyu/patches" \
  -H "Authorization: Bearer nmk_live_<YOUR_KEY>"