api

API是神马东西

api接口是开放给第三方开发者(如:erp等)一种访问和操作ecos系统内部数据记录的机制

如何访问api

请求地址

https://yourdomain/index.php/api

如果服务器设置过rewrite

https://yourdomain/api

请求方法

POST

提示:
    模拟POST请求,php可以参看[Snoopy.php https://www.google.com.hk/search?hl=zh-CN&source=hp&biw=1366&bih=637&q=Snoopy.php&aq=o&aqi=&aql=&oq=&gs_rfai=]

请求参数

系统参数

参数	类型	是否必须	描述

| app_id | String | Y | 产品类型 |

| method | String | Y | API接口名称 |

| date | String | Y | 时间戳，格式为yyyy-MM-dd hh:mm:ss，例如：2008-01-25 20:23:30 |

| format | String | N | 可选，指定响应格式。默认json |

| certi_id | int | Y | shopex分配给相关应用的证书号 |

| v | int | Y | API协议版本，可选值:1.0 |

| node_id | int | Y | 目的节点 |

| sign | String | Y | 签名,参看AC算法 |

AC算法

<?php
function get_sign($params,$token){
    return strtoupper(md5(strtoupper(md5(assemble($params))).$token));
}
function assemble($params)
{
    if(!is_array($params))  return null;
    ksort($params,SORT_STRING);
    $sign = '';
    foreach($params AS $key=>$val){
        $sign .= $key . (is_array($val) ? assemble($val) : $val);
    }
    return $sign;
}
?>

相关api所需参数

这个可以参看各app所提供的api文档

返回值

失败:{"rsp":"fail","res":"4003","data":"sign error"}
成功:{"rsp":"succ","res":"","data":"....."}

请求失败的时候 res 会返回相关错误信息

请求成功的时候 res 一般为空 data项返回相关数据信息(详情要看相关api接口文档)

api错误信息

'4001', 'error method'  // 错误的方法
'4003', 'sign error'    // 签名错误
'4007', $error_msg      // 其它错误