快速上手

API说明

• 所有请求均为POST请求
• 所有请求支持跨域，请求头header参考下面清单
• 需要登录权限的API，在请求头里要加上登录API返回的token
• 出参的格式如下

// 业务处理成功时返回
{
    code:0, // code为0，表示业务处理成功
    data:{  // 有返回数据的都在data里
        
    }
}

// 业务处理失败时返回
{
    code:-1, // code除了-1，还有其它更具体的异常编码,要参考API文档
    msg:'失败信息'
}

请求头header清单

• header传了非下面清单中的字段，则会提示跨域

字段	必须	说明
appid	N
terminal	N
token	N	登录时通过token验证合法性
Token-Seller-Account	N
Token-Merchant-Employee	N
sign	N
Access-Control-Allow-Headers	N
Origin	Y
Accept	Y
X-Requested-With	N
Content-Type	Y	application/json
Access-Control-Request-Method	N
Access-Control-Request-Headers	N

jquery的ajax请求

let apiRoot = 'https://lj.pointshow.cn/api/';
let apiName = 'resource/search';
let url = apiRoot + apiName;
let token = '***';  // 登录api返回的token
let data = {
    index:0,
    size:10
};
$.ajax({
    type: 'POST',
    url: url,
    data:JSON.stringify(data),
    dataType: 'json',
    contentType: 'application/json',
    headers:{
        token:token
    },
    success: function (result) {
       if (result.code == 0) {
           // 业务处理
           // todo ...
       } else {
           // 异常处理
           // todo ...
       }
    },
    error: function () {
       // 网络异常处理
    }
})

axios的请求

import axios from 'axios'

let apiRoot = 'https://lj.pointshow.cn/api/';

function getToken(){
    return '****'; // 登录api返回的token
}

function goLogin(){
    // todo  去登陆
}

function ajax(apiName = '', params = {}){
    let url = apiRoot + apiName;
    let token = getToken();
    if (!token) {
        if (!params.unToken) {   // 无token，且业务需要token时的处理
            goLogin();
            return new Promise((resolve, reject) => {
                setTimeout(() => {
                    return {};
                }, 0);
            })
        }
    }else{
        axios.defaults.headers['token'] = token;
    }
    return axios.post(url, params).then((res) => {
            return res.data;
    }).catch(ex => {
        console.error('网络异常，请检查网络');
    });
}

ajax('resource/search',{index:0,size:10}).then((res)=>{
    if(res.code == 0){
        // 业务处理
        // todo ...
    }
})