对接微信新版快速注册企业小程序,总结几个问题少走弯路,最后一个最重要最麻烦

8 阅读3分钟

大家好,我是小悟。

作为技术人员,最烦的应该就是对接第三方接口了吧,要是开发文档完整准确那还好,要是不完整不准确,对接的过程真的“🥚疼”。

在对接微信新版快速注册企业小程序的过程中总结了这几个问题,希望能帮助小伙伴少走弯路。

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>  

除了这些,你是否还有发现其他问题?欢迎在评论区分享。

图片

谢谢你看我的文章,既然看到这里了,如果觉得不错,随手点个赞、转发、在看三连吧,感谢感谢。那我们,下次再见。

您的一键三连,是我更新的最大动力,谢谢

山水有相逢,来日皆可期,谢谢阅读,我们再会

我手中的金箍棒,上能通天,下能探海