简介

权益销售系统开放平台（Card E-Sales Open Platform）是基于卡盟各类电商业务的开放平台，对系统客户提供各类API服务，例如下单购买、订单处理、商品数据等。本文档说明了开放平台的技术规范、传输协议等信息，供接入平台的商家使用，作为程序设计开发的指导。

协议架构

1. 传输采用HTTP协议。
2. 商家使用POST方法将请求发送到接口地址，经服务端处理后，将请求结果返回。
3. 传输数据采用UTF-8编码。
4. 将参数放入HTTP请求体（body）中，不要使用url参数，中文无需url编码。

接口约定

每次请求需传入以下参数：

签名计算方式

为了防止请求被伪造、篡改，每一次接口请求都需传入根据本次请求参数与key（密钥）计算获得的sign（签名）。

sign生成规则： md5(key + 参数1名称 + 参数1值 + 参数2名称 + 参数2值...)

+表示字符串连接运算，参数按照参数名的字典升序排列，md5加密后转为32位小写格式。

举例：某接口传入参数为a、z、b，传入值分别为1、2、3，那么sign值为： md5({key}a1b3timestamp{timestamp}z2) //（需用key值替换{key}，时间戳替换{timestamp}）

计算sign说明

由于参数recharge_template_input_items[*]可能出现中文，不同编程语言、字符集的排序算法可能不一致。例如对“一”和“二”两个汉字排序，按照utf-8编码排序，“一”排在“二”前面；而按照拼音排序，“二”排在“一”前面，服务端同时支持这两种排序方式。

注意：接入接口时不要将key值通过网络明文传输，请妥善保管，以免泄漏造成损失。

API通用返回格式

{
    code: ok,
    message: "请求成功",
    data: {
        ...
    }
}

code为服务器处理结果状态码，ok为成功，其它为失败，可参考状态码列表，data为与本次请求相关的业务