1、接口分页参数
page:页数
limit: 显示个数(默认10,最大999)
2、接口返回code
2000:成功
4001:未认证、认证失效
400、4000:为其他错误信息
3、JWT登陆接口方法
接口登录认证采用jwt方式:
认证成功后需要在http头部添加Authorization头部,值为认证成功后获取的JWT access_token,每次请求都要加上该头部信息(注意JWT和access_token之间有空格):
例如:
Authorization:JWT eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ0b2tlbl90eXBlIjoiYWNjZXNzIiwiZXhwIjoxNjMyODc1NzgyLCJqdGkiOiI0ZjZjNWQzMDQ3MGY0YmY2YjhhMzY2ZTA2MGNkNWRkNCIsInVzZXJfaWQiOiI0NTZiNjg4Yy04YWQ1LTQ2ZGUtYmMyZS1kNDFkODA0N2JkNDIifQ.996PGyxxxxSA__E9FBaQgB2DXAkh9AAoeJSXxIOl2U1
4、接口安全加密参数校验(默认未启用)
如果接口安全是启用状态,需要接口请求遵守以下规则:
1、在请求头部添加auth-api认证字段
2、该认证字段的值为校验接口安全值:
例如:332d3ddklllskkdwwwiissswewsw|1632392265.7424471|13234
该值分为5个部分:
(1)第一部分为md5值,计算方式是 key|1632392265.7424471|13234 整体的一个md5的值,其中key为服务器提供的加密秘钥,1632392265.7424471为当前时间戳,目前服务器允许30秒的时间误差,13234为5位随机字符。
(2)第二部分为固定字符‘|’
(3)第三部分为计算校验的当前时间戳
(4)第四部分为固定字符‘|’
(5)第五部分为随机5位字符(不能为|)
5、注意事项
(1)所有接口例如:/api/app/login/
中 login
后面的/
都要带上,否则访问报错