接口调试阶段

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

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

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

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

接口返回 100

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

接口返回 102

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

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

接口返回 104

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

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

接口返回 114

参考 104。

接口返回其他错误代码

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

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

results matching ""

    No results matching ""