#1 - 2021-12-8 19:42
bangumi大西王 (天生万物以养人，人无一物以报天)
https://github.com/bangumi/server/pull/3

(bgm38)

希望有客户端开发者建议一下
#2 - 2021-12-8 20:37
Sai🖖 (Awesome!)
错误返回应该全局统一规范下，例如

https://developer.twitter.com/en ... ror-troubleshooting
#3 - 2021-12-8 21:13
Sai🖖 (Awesome!)
infobox 解析的返回，如果是二维的可以这样



  "别名": [

      { v: "遠藤明吾",}

      {

        k: "第二中文名",

        v: "远藤明吾"

      },

      {

        k: "日文名",

        v: "遠藤明範"

      },

      …

    ]
#3-1 - 2021-12-8 21:22
ainopara
infobox 里有可能是这样的数据吗？忽略内容，只看格式的话
[第二中文名|远藤明吾|远藤明吾]
[第二中文名|远藤明吾|[第二中文名|远藤明吾]]
如果有可能的话，就不方便处理成 key value 字典的格式了。
#3-2 - 2021-12-8 21:25
Sai🖖
ainopara 说: infobox 里有可能是这样的数据吗？忽略内容，只看格式的话
[第二中文名|远藤明吾|远藤明吾]
[第二中文名|远藤明吾|[第二中文名|远藤明吾]]
如果有可能的话，就不方便处理成 key valu...
目前不支持多 value 和嵌套的
#3-3 - 2021-12-8 21:33
ainopara
Sai🖖 说: 目前不支持多 value 和嵌套的
ok，有这个约束就好处理了。是否可以认为原始数据中的 ={} （被解析成数组）只会出现在顶层？
#3-4 - 2021-12-8 21:34
bangumi大西王
ainopara 说: ok，有这个约束就好处理了。是否可以认为原始数据中的 ={} （被解析成数组）只会出现在顶层？
对
#3-5 - 2021-12-8 21:43
ainopara
Trim21 说: 对
wiki 字段内容的字典结构
{"别名": ... }
是否可以也改为这种格式
[
  {
    "k": "别名"
    "v": ...
  },
  ...
]
这样客户端可以用模型来解析，因为这样一来wiki 字段内容里的 key 不再是一个不确定的值了。
而且还可以保留原始数据里的顺序信息
#3-6 - 2021-12-8 21:45
bangumi大西王
ainopara 说: wiki 字段内容的字典结构
{"别名": ... }
是否可以也改为这种格式
[
  {
    "k": "别名"
    "v": ....
可以是可以，但我感觉api返回这样的数据太啰嗦了...关键就是顶级字段之间的顺序有没有意义

解析器把原始内容解析成这样的格式倒是可以
#3-7 - 2021-12-8 21:56
ainopara
Trim21 说: 可以是可以，但我感觉api返回这样的数据太啰嗦了...

解析器把原始内容解析成这样的格式倒是可以
感觉这样改动的话对客户端会比较友好，数据使用起来会方便很多。而且如果是内容作为 key，会有客户端直接遍历这个 key 来展示，显示出来内容的顺序就是不确定的，我认为这是接口设计时需要避免的。
#3-8 - 2021-12-8 22:00
bangumi大西王
ainopara 说: 感觉这样改动的话对客户端会比较友好，数据使用起来会方便很多。而且如果是内容作为 key，会有客户端直接遍历这个 key 来展示，显示出来内容的顺序就是不确定的，我认为这是接口设计时需要避免的。
有道理
#4 - 2021-12-8 21:21
ainopara
删除了回复