大家好,我是小悟。
作为技术人员,最烦的应该就是对接第三方接口了吧,要是开发文档完整准确那还好,要是不完整不准确,对接的过程真的“🥚疼”。
在对接微信新版快速注册企业小程序的过程中总结了这几个问题,希望能帮助小伙伴少走弯路。
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>
除了这些,你是否还有发现其他问题?欢迎在评论区分享。
谢谢你看我的文章,既然看到这里了,如果觉得不错,随手点个赞、转发、在看三连吧,感谢感谢。那我们,下次再见。
您的一键三连,是我更新的最大动力,谢谢
山水有相逢,来日皆可期,谢谢阅读,我们再会
我手中的金箍棒,上能通天,下能探海