大家好,我是小悟。
作为技术人员,最烦的应该就是对接第三方接口了吧,要是开发文档完整准确那还好,要是不完整不准确,对接的过程真的“🥚疼”。
在对接微信新版快速注册企业小程序的过程中总结了这几个问题,希望能帮助小伙伴少走弯路。
1、示例任务状态枚举值缺失
接口调用成功后,最初的任务状态status枚举值是0。
开发文档列举。
实测结果。
发起请求: https://api.weixin.qq.com/wxa/component/fastregisterenterpriseweapp?access_token=ACCESS_TOKEN&action=create{"code":"企业代码","component_phone":"第三方的联系电话","name":"企业名称","new_version":true}返回结果:{"errcode":0,"authorize_url":"https://mp.weixin.qq.com/publicpoc/fastregisterenterprisewxanew?action=scan&tid=任务id#wechat_redirect","errmsg":"create task ok","taskid":"任务id","status":0}2、接口调用成功返回的msg不一样
对接过微信开放平台接口的小伙伴应该都知道,一般是状态码errcode返回的0和描述信息errmsg返回的“ok”表示成功。
但创建任务errmsg实际上返回的是“create task ok”,查询创建任务状态实际上返回的是“query ok”。
要是按照开发文档的示例或者以往的习惯,可能判断出错,只有把结果打印出才会发现。
开发文档示例。
实测结果。
创建任务返回结果:{"errcode":0,"authorize_url":"https://mp.weixin.qq.com/publicpoc/fastregisterenterprisewxanew?action=scan&tid=任务id#wechat_redirect","errmsg":"create task ok","taskid":"任务id","status":0}查询创建任务返回结果:{"errcode":0,"authorize_url":"https://mp.weixin.qq.com/publicpoc/fastregisterenterprisewxanew?action=scan&tid=任务id#wechat_redirect","errmsg":"query ok","taskid":"任务id","status":0}3、错误码没有给全
因为接口返回的是错误描述是英文格式,为了友好性,需要将状态码对应的描述翻译成中文显示,这就需要开发文档要列出全部的错误码对应的描述。
目前发现状态码47001对应错误描述data format error、
状态码89253对应错误描述lack of some params、
状态码89290对应错误描述enterprise info not found没有列出来。
开发文档示例。
实测结果。
{"errcode":47001,"errmsg":"data format error rid: 137ad69f-b30edb22-5136b356"}{"errcode":89253,"errmsg":"lack of some params rid: 69f5136b-350edb22-137ad6b3"}{"errcode":89290,"errmsg":"enterprise info not found rid: 69f44e6b-6f9f7c66-6b4b5627"}4、审核结果推送示例不一致
发起创建任务后会返回任务id,也就是taskid,通过taskid唯一识别来更新审核状态。
从业务层面来说,这个状态是需要看到的,但测试得需要部署起来并操作一遍注册,微信才会推送,所有说是最重要也是最麻烦的。
开发文档示例。
实测结果。
<xml><AppId><![CDATA[第三方平台appid]]></AppId><CreateTime>1535442403</CreateTime><InfoType><![CDATA[notify_third_fasteregister]]></InfoType><appid>创建小程序appid</appid><status>0</status><auth_code>xxxxx第三方授权码</auth_code><msg>OK</msg><info><taskid><![CDATA[任务id]]></taskid></info></xml>除了这些,你是否还有发现其他问题?欢迎在评论区分享。
谢谢你看我的文章,既然看到这里了,如果觉得不错,随手点个赞、转发、在看三连吧,感谢感谢。那我们,下次再见。
您的一键三连,是我更新的最大动力,谢谢
山水有相逢,来日皆可期,谢谢阅读,我们再会
我手中的金箍棒,上能通天,下能探海