Fecshop Api 登录和验证 ¶

对于需要用户登录这类安全认证的请求，需要先进行用户登录，获取token ，然后每次访问带上token，fecshop根据token做安全认证

用户登录 ¶

Api获取Token

请将下面url中出现 http://fecshop.appapi.fancyecommerce.com的部分替换成您自己的域名

URL: http://fecshop.appapi.fancyecommerce.com/v1/account/login

格式：json

方式：post

Request JSON Data(Body)：

参数名称	是否必须	类型	描述
username	必须	String	appadmin后台的用户名
password	必须	String	appadmin后台的用户名对应的密码

注意：上面的username password是appadmin入口，也就是后台的用户名和密码

Response JSON Data(Body)：

格式：json

参数名称	是否必须	类型	描述
code	必须	Number	200 代表成功
access-token	必须	String	Token字符串

Example：{"access-token":"QBwhbzKFewRzQp6lrerereqiZAw","code":200}

用户限制 ¶

因为后台用户很多，公司的各个客服，产品编辑都会有账户，因此，我们 希望可以指定仅仅某些或者某个账户，可以在appapi入口下进行Api登录获取access-token， 我们可以通过下面的 配置参数设置

打开配置文件：@appapi/config/fecshop_local.php

/** 
 * 该配置用来设置：允许那些账户在appapi入口进行登录获取token
 * 1.apiUserAllow数组的值为空：代表默认是所有的后台用户
 * 2.apiUserAllow数组中设置了用户名（数组可以设置多个），那么，只有包含在这个数组中的用户，才可以用于appapi用户登录获取access-token。其他的账户获取token就会失败
 * 3.默认该数组为空，允许所有的appadmin的后台用户进行登录获取access-token
 */
'apiUserAllow' => [
   // 'admin','terry'
],

在 apiUserAllow 配置数组中添加允许的后台账户username即可， 如果不填写，则为空，则允许所有的后台账户

php 请求例子： ¶

<?php

function getCurlData($url,$type="get",$data=array(),$timeout = 10) {
    //对空格进行转义
    $url = str_replace(' ','+',$url);
    if ($type == "get") {
        if (!empty($data) && is_array($data)) {
            $arr = [];
            foreach ($data as $k=>$v) {
                $arr[] = $k."=".urlencode($v);
            }
            $str = implode("&",$arr);
            if (strstr($url,"?")) {
                $url .= "&".$str;
            } else {
                $url .= "?".$str;
            }
        }
    }
	
    $data = json_encode($data);
    $ch   = curl_init();
    //设置选项，包括URL
    curl_setopt($ch, CURLOPT_URL, "$url");
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch,CURLOPT_TIMEOUT,$timeout);  //定义超时3秒钟  
    if($type == "post"){
        // POST数据
        curl_setopt($ch, CURLOPT_POST, 1);
        curl_setopt($ch, 
            CURLOPT_HTTPHEADER, 
            [
                'Accept: application/json',
                'Content-Type: application/json',
                'Content-Length: ' . strlen($data)
            ]
        );
        // 把post的变量加上
        curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
    }
    //执行并获取url地址的内容
    $output = curl_exec($ch);
    //echo $output ;
    //释放curl句柄
    curl_close($ch);
    //var_dump($output);exit;
    
    return $output;
}
$api_url = 'http://fecshop.appapi.fancyecommerce.com/v1/account/login';
$post_data = [
    'username'     => 'username',
    'password'     => '12345678'
];
$return_data = getCurlData($api_url,'post',$post_data,100);
var_dump($return_data); 

?>

{"access-token":"QBhb4zKFF6prrKRzQp6lM3h3MBo3qiZAw","code":200}

用户验证 ¶

在上面步骤，通过登录api获取了access-token后， 我们在需要token验证的Api请求中，在request header中加入access-token即可，这样，就可以验证用户的合法性

Request Header ¶

参数名称	是否必须	类型	描述
access-token	必须	String	身份验证，获取access-toekn参看上面的“用户登录”部分

用户验证-举例： ¶

我们要访问这个url：http://fecshop.appapi.fancyecommerce.com/v1/article/test

这个url是需要token验证的，下面是我们的示例代码，access-token是上面得到的， 直接填写到下面。

<?php
function getCurlData($url,$type="get",$data=array(),$timeout = 10) {
    //对空格进行转义
    $http_header = array();
    if(isset($data['access-token'])){
        $http_header[] = 'access-token: ' . $data['access-token'];
        unset($data['access-token']);
    }
    $url = str_replace(' ','+',$url);
    if ($type == "get") {
        if (!empty($data) && is_array($data)) {
            $arr = [];
            foreach ($data as $k=>$v) {
                $arr[] = $k."=".urlencode($v);
            }
            $str = implode("&",$arr);
            if (strstr($url,"?")) {
                $url .= "&".$str;
            } else {
                $url .= "?".$str;
            }
        }
    }
    
    $ch   = curl_init();
    curl_setopt($ch, CURLOPT_URL, "$url");
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch,CURLOPT_TIMEOUT,$timeout);  //定义超时3秒钟
    if(strtolower($type) == "post"){
        $data = json_encode($data);
        // POST数据
        curl_setopt($ch, CURLOPT_POST, 1);
        $http_header[] = 'Accept: application/json';
        $http_header[] = 'Content-Type: application/json';
        $http_header[] = 'Content-Length: ' . strlen($data);

        // 把post的变量加上
        curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
    }
    curl_setopt($ch, CURLOPT_HTTPHEADER,$http_header);
    //执行并获取url地址的内容
    $output = curl_exec($ch);
    //echo $output ;
    //释放curl句柄
    curl_close($ch);
    //var_dump($output);exit;
    return $output;
}
$url = 'http://fecshop.appapi.fancyecommerce.com/v1/article/test';
$data['access-token'] = "5mNtDqOQFodXHyS68hmUP3WdXw1TpJ-a";
$data['sku'] = "GMYR095-9";
$data['warehouse_name'] = "CN";
$data['country_code'] = "US";
$data['quarkscm_shipping_code'] = "RP";
$res = getCurlData($url,'post',$data);
echo $res;
?>

可以看到输出：(这个是测试请求，只是把用户post的数据返回回来)

{"sku":"GMYR095-9","warehouse_name":"CN","country_code":"US","quarkscm_shipping_code":"RP"}