本文档主要描述第三方系统如何接入本充值平台，实现下单、订单查询、产品查询等功能。

URI和API-USER-NAME、API-CERT请联系本平台商务获得。

---

请求和响应

Request

使用HTTP请求，通过POST（仅接受POST数据）动作提交请求。

Request Headers

API-USER-NAME: $USER_NAME
API-NAME:  $CALL_NAME
API-TIMESTAMP: $TIMESTAMP
API-SIGNATURE: $SIGNATURE

名称	描述	取值说明
API-USER-NAME	API调用的用户名	由本平台提供
API-NAME	所请求的API名称	参考API CALL
API-TIMESTAMP	UNIX时间戳	2015-12-22 12:30:50+0800的时间戳为1450758650
API-SIGNATURE	签名	由API-TIMESTAMP+密钥做md5生成，签名方法

Request Body

使用POST提交的数据，键值对方式（form-data或者x-www-form-urlencoded），具体每个接口参数参考接口说明。

Response

返回JSON格式数据。

名称	描述	取值说明
ack	请求结果	success代表成功，failure代表失败
message	返回信息	失败时，返回失败原因
code	请求返回码	参考值

以下为ProductQuery返回成功的实例：

{
    "ack":"success",
    "message":"",
    "code": "000",
    "product":[
        {
            "product_id":"1",
            "product_name":"全国流量10M-3元",
            "product_desc":"",
            "product_category":"移动-流量-广东号码-全国流量-快充",
            "product_price":"2.85"
        },
        {
            "product_id":"2",
            "product_name":"全国流量30M-5元",
            "product_desc":"",
            "product_category":"移动-流量-广东号码-全国流量-快充",
            "product_price":"4.75"
        }
    ]
}

---

签名

名称	描述	取值说明
API-TIMESTAMP	UNIX时间戳	同Request中headers的API-TIMESTAMP一致
API-CERT	密钥	由本平台提供，请再获取到登陆账号后联系技术获得密钥

以下为php签名代码

$SIGNATURE = md5(API-TIMESTAMP . API-CERT);

例子：

API-TIMESTAMP: 1450792560

API-CERT: 123456

签名为：1819ee00b648b95056c6e174f60ce94d