V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
silverfox
V2EX  ›  程序员

百度推送 3.0 REST API 文档错误整理

  •  
  •   silverfox · 2015-04-17 22:33:53 +08:00 · 5993 次点击
    这是一个创建于 3512 天前的主题,其中的信息可能已经有所发展或是发生改变。

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

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

    HTTPS 接口地址证书错误

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

    HTTP Request Content-Type Header 描述错误

    Error2

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

    公共请求参数 apiKey 名字错误

    Error3

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

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

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

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

    第 1 条附言  ·  2015-04-18 08:11:22 +08:00
    今早做进一步测试的时候,发现 apiKey 这个名字没有错误,是我被文档上的「PHP签名算法示例」误导了,抱歉抱歉。
    5 条回复    2015-04-18 19:52:28 +08:00
    langhua9527
        1
    langhua9527  
       2015-04-17 22:51:38 +08:00
    居然用百度云推送。。。。后面还有更多的坑等着你呢。。。建议用个推吧
    langhua9527
        2
    langhua9527  
       2015-04-17 22:52:05 +08:00
    现在换推送工具还来的及的
    nocturnal
        3
    nocturnal  
       2015-04-18 01:04:15 +08:00 via Android
    百度听说给所有用户群发过一条测试的推送 求验证真实性
    kslr
        4
    kslr  
       2015-04-18 08:42:43 +08:00
    @nocturnal 推送没收过,测试短信收过.
    l12ab
        5
    l12ab  
       2015-04-18 19:52:28 +08:00
    试试友盟信鸽推送
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   3098 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 21ms · UTC 14:10 · PVG 22:10 · LAX 06:10 · JFK 09:10
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.