接口调试阶段

在对接初期,需要先调通接口,完成一次成功的发送请求和接收返回值过程。在接口调用时:

  • 一定要确保返回错误码是 1,才能认为调用成功。其他错误码参考相应接口的说明进行处理,切忌不处理报错不断重复同一个报错请求,造成不必要的资源浪费
  • 如果没有正确处理错误码,很可能会导致双方平台数据不一致

初期通用问题如下(更多问题需要查看具体接口错误码说明):

接口无返回,此时可能是超时了,请检查

接口返回 100

  • 是否 Post 请求?
  • 检查各项参数名字是否准确(大小写敏感),参数格式是否正确,必填参数是否都有填。
  • 传参的数据格式不对

接口返回 102

  • 查看 SID 是否正确
  • safeKey 是否是 SECRET + timeStamp md5 加密后的结果(注意是小写)
  • SECRET 最好复制,不要手动填写,注意字母混淆
  • timeStamp 是否距当前时间 20 分钟之内的秒数(不是毫秒数)
  • 合同到期或者机构账号有欠费(联系您的客户经理)

注:如果 ClassIn 教室可以正常使用,那说明不是第五条。

接口返回 104

104 是一种不预期的错误,如果出现 104,建议重新发送请求。

  • 注册接口(添加学生、老师接口、修改接口)的请求出现 104,重新请求即可
  • 新建课程、课节的请求出现 104,需要用到 courseUniqueIdentity 这个参数,在第一、第二次请求都用同一个参数的情况下,就不会造成重复创建。否则有可能出现第一次其实成功了,第二次又创建一个相同课程/课节的情况。

接口返回 114

参考 104。

接口返回155 数据数组不可为空

一般就是要求传数组的参数格式不对。这个具体要看编程语言的语法。

以python传入数组 classlist 举例(数据结构简化,仅用于举例):

Clist=[{"cid":123455,name : "test "},{"cid":33211,name:"test2  "}]    
data = {"其他参数": "aabbcc","classlist":Clist}

报数据数组不可为空
此时改Clist定义即可:

Clist='[{"cid":123455,name : "test "},{"cid":33211,name:"test2  "}]'

这只是一个例子,其他代码按实际情况分析。

接口返回其他错误代码

请参考具体接口下面关于错误码的说明,并相应调整业务调用逻辑

  • 比如 134 手机号不合法,则需要使用合法手机号。(手机号规则为: 例如:美国手机号 1 (800) 643-7676 填成 001-8006437676;中国大陆手机号填成 15800000001)

results matching ""

    No results matching ""