接口调试阶段
在对接初期,需要先调通接口,完成一次成功的发送请求和接收返回值过程。在接口调用时:
- 一定要确保返回错误码是 1,才能认为调用成功。其他错误码参考相应接口的说明进行处理,切忌不处理报错不断重复同一个报错请求,造成不必要的资源浪费
- 如果没有正确处理错误码,很可能会导致双方平台数据不一致
初期通用问题如下(更多问题需要查看具体接口错误码说明):
接口无返回,此时可能是超时了,请检查
- url 是否准确。以 https://root_url/partner/api/course.api.php?action=register 为例,注意 root_url 要替换为 api.eeo.cn
- 网络是否通畅
- 其他问题,如果是代码发送的,建议先改用postman试试: https://docs.eeo.cn/api/zh-hans/appendix/Gettingstartedguide.html
接口返回 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)