Current position: document > > Traffic query that has been used

Functional description

The traffic that has been used to query the traffic card (only 13 bit cards are supported)

URL

/v1/iotUsedFlow

Request method

GET POST

Request parameters

Parameter fields Field type Is it necessary Parameter description
agentid string Yes Merchant ID
cardNum string Yes Card number, support 20 bit ICCID/11 bit or 13 bit cell phone number
ti string Yes Time stamp UTC/GMT+08:00, example: 2016-09-23 17:33:50 is 1474623230
format string No JSON or XML, the default is JSON

Invocation direction

Third party application server, HTT. server

Request examples

http://api.ht-telecom.com/v1/iotLeftFlow?agentid=**&cardNum=**&format=json&ti=**&sign=**

Return to the example, JSON format

/**Successful return to an example**/
{
    "code": 0,
    "msg": "Error code description",
    "data": 
        {
            "usedFlow": "***"
        }
}

/**Failure to return to the sample**/
{
    "code": -1,
    "msg": "Error code description",
    "data": "" 
} 

Return field description

Parameter fields Field type Is it necessary Parameter description
code int_32 Yes Error code, 0 for success, others fail
msg string Yes Error code description
data JSON Object Yes Returned data
--leftFlow string Yes Residual flow, unit M