Fetch shipment security key
Fetch shipment security key API gives the unique security key for each shipment that the enterprise can consume and store corresponding to a shipment in the system and can pass this key in the tracking page parameters to ensure higher security
Overview
- Fetch shipment security key API gives the security key for each shipment that you can consume and store corresponding to a shipment in the system.
- This security key is useful if you have the security feature enabled on Clickpost's tracking page. If the security feature is enabled on your Clickpost tracking page, you need to ensure you consume the shipment security key and pass it in URL param key while rendering the tracking page at your end.
With the security feature enabled, if you do not pass the security key in the tracking page URL for each shipment, the tracking page will not work as expected.
Usecase
This is a standard API which applies to all MPS (Multi-Piece Shipment) and SPS (Single Piece Shipment) orders
Geography
This is a standard API which supports all shipments created and transported within
- India
- North America
- Europe
- Middle East
- South East Asia
Query Parameters
Field Name | Data Type | Field | Description | Max Length | Example |
---|---|---|---|---|---|
key | string | Mandatory | Unique license key provided by Clickpost for the enterprise | 00000000-0000-0000-0000-000000000000 | |
waybill | string | Mandatory | The Air Way bill number | 19025410024064 | |
cp_id | num | Mandatory | The carrier partner ID Refer to the list | 4 |
Response
meta
[meta parameters]
Field Name | Data Type | Description | Example |
---|---|---|---|
success | Boolean | Indicates the success of the API request | true |
message | String | The message from Clickpost. In case of success it will be "SUCCESS". In case that there are no carrier partners that are servicing the pincodes it will be”Pin code not serviceable" | "SUCCESS" |
status | HTTP Code | The HTTP response status code of the API request | 200 |
result
[result parameters]
Field Name | Data Type | Description | Example |
---|---|---|---|
waybill | string | The airway bill number of the shipment for which the security key needs to be fetched | 19025410024064 |
cp_id | num | The carrier partner ID | 4 |
security_key | string | The security key | "c020a025-9511-4a46-b1bd-31e87ad64c65" |
reference_number | string | The unique reference number of the API response | "CR61622155" |
API Response
{
"meta": {
"status": 200,
"message": "Success",
"success": true
},
"result": {
"waybill": "19025410024065",
"cp_id": 4,
"security_key": "c020a025-9511-4a46-b1bd-31e87ad64c65",
"reference_number": "CR61622155"
}
}
Updated over 1 year ago