概述:
- 该接口文档均为WAP端、小程序端、APP端使用;
- 请求接口域名均为平台分配的二级域名或者独立域名;
- 请求地址:域名+'/wapapi'+相应接口地址(wapapi为商城相关基础api路径,不同则单独说明);
- 请求示例:https://app.vslai.com.cn/wapapi/config;
接口验证说明:
- 请求method均为POST方式(部分接口请求method不同单独说明);
- 每个接口需要在请求头header加上验证接口签名sign;
- 授权码:总管理员分配的后台授权码进行拼接加密;
公共请求头参数说明:
参数名 |
类型 |
是否必须 |
说明 |
sign |
String |
是 |
接口验证签名 |
token |
String |
否 |
用户唯一标识(需要用户标识验证的接口必须携带) |
所有接口返回数据必须包含code,data,message 字段;
code大于等于0均为正常返回,所有返回数据都显示在data字段;
code小于0则为错误返回,需要返回message信息,根据业务需要显示相关提示;
公共返回字段说明:
字段 |
类型 |
示例值 |
说明 |
code |
Number/String |
0 |
返回结果状态码 |
data |
Object/String/Number |
-- |
返回数据结构 |
message |
String |
操作成功 |
返回提示信息 |
公共状态码code说明:
状态码 |
说明 |
处理方案 |
大于等于 0 |
正常返回 |
根据业务需求处理相关逻辑 |
小于 0 |
错误返回 |
根据业务需求提示相关错误message |
-1000 |
登录信息已过期 |
根据业务需求重新登录 |
-10000 |
平台商城已过期 |
根据业务需求提示相关message |
-10001 |
商城移动端已关闭 |
根据业务需求提示相关message |
-10013 |
店铺应用不存在 |
根据业务需求提示相关message |