#1 - 2021-3-8 22:59
可乐呀
根据官方OpenAPI3.0文档自动生成的,只要文档没错应该就没问题(bgm24)

https://github.com/cokemine/BGM-Types

已适配新版 API 新增的两个接口(bgm25)
#2 - 2021-3-8 23:04
(天生万物以养人,人无一物以报天)
文档是有错的(bgm38)
具体错哪我记得有个帖子
#2-1 - 2021-3-8 23:10
可乐呀
那缩小一下范围,只要文档的response没错就行 (bgm38)
#2-2 - 2021-3-8 23:11
bangumi大西王
可乐呀 说: 那缩小一下范围,只要文档的response没错就行
就是response有错

https://bgm.tv/group/topic/350650
注意 :`GET /collection/{subject_id}`的返回值里有一个field叫`tags`,返回的是一个由`String`组成的`List`。但是当这个条目用户没有输入任何标签时,tags返回的是一个包含一个空字符串的`List`(`[""]`),而非`null`或者`[]`
不过我不知道后来有没有修复了
#2-3 - 2021-3-8 23:19
可乐呀
Trim21 说: 就是response有错

https://bgm.tv/group/topic/350650注意 :`GET /collection/{subject_id}`的返回值里有一个field叫`tags...
我康了康自动生成的这个地方,问题不大(bgm24)
#3 - 2021-3-8 23:24
(✨️make bangumi great again✨️)
万一哪天改了你不死了(bgm38)
#3-1 - 2021-3-8 23:29
可乐呀
Sai老板咕咕咕肯定不会有大更新的(都已经两三年没更新了)
#4 - 2021-3-8 23:45
(プリキュアなりたい)
居然还发布npm了(bgm37)
#5 - 2021-5-19 23:59
(bgm38)好吧这个文档的问题确实很大。
比如Subject里没有书籍条目的vols_count,但是实际返回的数据是有的。
还有就是缺省了太多required: true,导致生成出来的声明文件很多都变成了可选值,凑合着用可能得一直加可选链(bgm27)
#6 - 2021-12-17 02:19
(天生万物以养人,人无一物以报天)
有没有想法更新一下
#6-1 - 2021-12-17 20:03
可乐呀
过几天看看(bgm38)
#6-2 - 2021-12-19 17:41
可乐呀
已经更新了!
#7 - 2021-12-27 12:31
和server的github action联动搞个codegen然后发布到npm吧(bgm38)
#8 - 2021-12-27 13:27
(hhh汝视视汝)
如果文档够靠谱可以直接上codegen (bgm38)
推荐openapi-generator里的ts-fetch
#8-1 - 2021-12-27 13:54
bangumi大西王
没有安全问题的话API是不引入break change的,但是在openapi里对应的类型名称就不保证了。可能会折磨挺多自动生成工具…
#8-2 - 2021-12-27 21:41
ouoω
Trim21 说: 没有安全问题的话API是不引入break change的,但是在openapi里对应的类型名称就不保证了。可能会折磨挺多自动生成工具…
生成工具还行吧 一般都是重新生成的
在强类型语言中 人类可能会需要手动改代码 (比人类不知道需要改要好)