技术团队工作中,接口的规则相当重要。接口可分为两部分,入参和返回值。下面就简单阐述我的相关思考:
返回结果,使用json表示:
{“code”:0,”thirdCode”:”“,”msg”:”[font=宋体]操作成功[/font]”, “data”:{“fUid”:2,”fToken”:”31ba90af-5468-4d87-9b6eeaa001112ab1f”,”fTokenExptime”:1431059268000}}
说明如下:code:整型,错误代码,如果本次操作成功为0,10000以内表示返回值合理;10000-19999为系统自定义错误;20000-29999为第三方错误;
thirdCode:字符串,表示第三方库返回的结果编码,默认为空字符串
msg:字符串,msg是本次操作的简单说明,“errorCode=0”时为操作成功,其他则反映对应errorCode表示的信息
data:具体返回的数据
code枚举值如下:
空数据:1
未知错误 10001;
校验错误 10002;
权限错误 10003;
参数错误 10004;
XX支付平台:21001;
XX短信平台:22001。
举例说明:某人刚注册一个网站,接下来登录成功:{“code”:0,”thirdCode”:null,”msg”:”登录成功”, “data”:{“fUid”:2,”fToken”:”31ba90af-5468-4d87-9b6e-aa001112ab1f”,”fTokenExptim