获取订单

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": ""
    }
}