English
  • Login
  • |
  • Register

1Tracking API

Webhook URL receives tracking result
When the tracking is updated and triggers your parcel status update reminder in the webhook setting, the system will make a POST request to the callback URL that you defined in the webhook page. The post body contains a JSON string of the below data.
Currently, we support HTTP or HTTPS urls links to ensure the security of the site when SSL links are enabled. But keep in mind that your endpoint is going to be wide-open on the internet.
Signature Verification:
You can verify safely about the source of POST data to make sure it is from 1Tracking(Without verification, it is also possible to directly resolve POST data).Below are steps about safety verification:
1. Analyze the two parameters ('timestamp' and 'sign') in the POST data.
2. Use your registered email address on 1Tracking and the parameter 'timestamp' to generate 'sign', and then verify the generated 'sign' with the 'sign' from POST data(Signature Algorithm is SHA256).
Response 200
body:

{

"list":[

{

  • "track_num":"Tracking number",
  • "inner_num":"Order NO.",
  • "result":"parcel status code",
  • "logis_code":"Courier code",
  • "country":"destination country name",
  • "residence_time":"Residence Time",
  • "haulage_time":"Transit Time",
  • "fromDetail":[

{

  • "date":"origin track time",
  • "status":"origin track description",
  • "address":"origin track address"

}

],

"toDetail":[

{

  • "date":"destination track time",
  • "status":"destination track description",
  • "address":"destination track address"

}

],

"latest":{

  • "date":"recent track time",
  • "status":"recent track description",
  • "address":"recent track address"

}

}

],

"status":{

"code":200,

"msg":"Success."

},

"verify":{

"timestamp":1536053892382,

"sign":""

}

}