getCatalogTagExclusion
解析一组 tag 排除
exclude_tag_id= 与 exclude_tag_tree= 会排除什么:接收与 /v2/catalog/works 相同的这两个参数,返回展开后的 tag id,以及带有其中任一 tag 的全部作品 id。站点用自己的表出作品列表时,剔掉 work_ids 即可套用读者的屏蔽;自有 tag 镜像的站点也可以改用 tag_ids 匹配。至少要给一个参数。响应只取决于参数,请按参数集缓存。可匿名调用,按 IP 地址限流;应用密钥或带 catalog:read 的用户访问令牌各有更高的额度。
get
/v2/catalog/tag-exclusion scope
catalog:read可匿名调用(不带凭据按 IPv4 地址或 IPv6 /64 限流(默认 30 次/分钟、1,000 次/天);带 nmk_ 应用密钥或带 catalog:read 的用户访问令牌则走各自更高的额度)参数
| 参数 | 类型 | 位置 | 说明 |
|---|---|---|---|
exclude_tag_id | string | query | 逗号分隔的规范 tag id,最多 100 个。每个只排除带有它自己的作品。 |
exclude_tag_tree | string | query | 逗号分隔的规范 tag id,最多 100 个。每个排除带有它自己或其下任一 tag 的作品。 |
响应
objectstring必填类型判别字段,恒为 tag_exclusion。
枚举tag_exclusiontag_idsstring[]必填参数排除的全部 tag:精确 id,以及每个树 id 连同其下所有 tag。升序。永不为 null。
work_idsstring[]必填带有 tag_ids 中任一 tag 的全部 catalog 作品,不论来源、剧透等级与分级。升序。永不为 null。即 /v2/catalog/works 在相同参数下剔除的作品,用自己的表出列表的站点剔掉它们即可保持一致。
请求示例
cURL
curl "https://api.nextmoe.dev/v2/catalog/tag-exclusion"