获取订单
1 软件请求数据说明
1.1 Header说明
API-USER-NAME: $USER_NAME //软件填写的USER-NAME
API-NAME: GetOrder //获取订单的请求固定为GetOrder
API-TIMESTAMP: $TIMESTAMP //UNIX时间戳
API-SIGNATURE: $SIGNATURE //签名
名称 | 描述 |
---|---|
API-USER-NAME | 填写在软件上的USER-NAME |
API-NAME | 获取订单为GetOrder,设置订单为SetOrder |
API-TIMESTAMP | UNIX时间戳,例如 2015-12-22 12:30:50+0800的时间戳为1450758650 |
API-SIGNATURE | 签名,方法见下方说明。 |
签名由API-TIMESTAMP+密钥做md5生成,其中密钥为填写在软件上的USER-CERT
1.2 Body说明
键名 | 描述 |
---|---|
provider_code | 填写在软件上的 “供应代号” |
2 平台返回数据说明
返回数据为json格式,结构分两层,第一层为请求结果描述,第二层为订单信息。
第一层说明
键名 | 描述 |
---|---|
ack | 只能含有failure和success两种结果,当请求成功为success,请求失败为failure。特别说明,假如获取的时间是暂时没有订单需要处理,此参数也为success,无订单的情况软件会判断order中的number字段是否为空 |
message | 请求返回的信息,一般在ack为failure的时候,此参数才会有值,成功可以设置为空值 |
order | 此参数为一个结构体,在下面会描述订单结构内容 |
第二层说明(订单结构体)
键名 | 描述 |
---|---|
number | 平台单号,在处理完订单会用这个单号返回状态给平台 |
phone_number | 手机号码 |
purchase_param_1 | 参数1 |
purchase_param_2 | 参数2 |
purchase_param_3 | 参数3 |
purchase_param_4 | 参数4 |
{
"ack": "success",
"message": "",
"order": {
"number": "CZ......",
"phone_number": "13.....",
"purchase_param_1": "111",
"purchase_param_2": "222",
"purchase_param_3": "333",
"purchase_param_4": ""
}
}