今天在适配百度推送 3.0 API 过程中发现文档上有几处错误，如果不参考其他信息的话，按照文档使用这个 API 确实是一大挑战。

我把现在遇到的文档错误都整理出来，如果 V2 有人能给百度推送开发团队提个醒，也算是造福广大开发者了。

HTTPS 接口地址证书错误

这个地址的 HTTPS 目前配置的证书错误

HTTP Request Content-Type Header 描述错误

• 如果参照文档实现，推送服务会提示error_msg=Request Params Not Valid, check timestamp param not exist，即使已传入timestamp参数。
• 正确方法，如果是 POST 请求，应该使用Content-Type: application/x-www-form-urlencoded; charset=utf-8

公共请求参数 apiKey 名字错误

• 如果参照文档实现，推送服务会提示error_msg=Authentication Failed
• 正确方法，apikey参数应更名为api_key

公共请求参数 sign 值应全小写

• 严格的说，这个不能算是文档错误，只是针对 2.0 迁移至 3.0 的说明不够详细。
• 之前的 2.0 API 中sign值是不区分大小写的，但是 3.0 要求必须小写。

新的 API 相比于 2.0 确实有比较大的改进，如果文档能更准确一些就更好了。