腾讯云的 API 中给出了数据类型的说明，还挺好的。

[xiqingongzi]

https://cloud.tencent.com/document/api/213/9451

https://cloud.tencent.com/document/api/213/9452

个人觉得两个好处

1. 自己封装 SDK 时，可以写一些枚举类型的参数，使用时会比较友好，用户不需要自己输入了，直接调用枚举的 key 就好了。
2. API 返回的数据不明白的时候，直接有个地方可以去查。

[night98]

腾讯云通用 ocr 识别的上传部分我调了两星期都没调通，发工单打电话还是解决不了，最后用 oss 解决的。唉

[xiqingongzi]

@night98 #1 hhh，帮你 @tencentcloud