为何api文档如此的差劲

https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/ocr/ocr.idcard.html

五六年前接入微信支付，发现api乱的很，大小写，驼峰式混用。

到今天还是这样，文档还是错的，一个接口，返回数据格式都不统一，文档validDate，实际返回valid_date