Note: this article pertains to custom built integrations, or platforms. It does not apply to Shippit supplied plugins/connectors.

To assist Shippit’s support of our custom built API consumers we ask that requests to our HTTP APIs supply additional information in the request headers. The headers are as follows:

 

Request Header Purpose/Usage Example Type/Limits Mandatory
user-agent A string to help identify technical information about the integration. The value supplied can be anything. Useful information includes, software library names, release versions/dates. Shippit_Shipping for Magento2 v1.5.3 200 chars Optional, but strongly encouraged
x-shippit-partner A string to identify the entity developing and maintaining the integration. This could be a business name for self-maintained integrations, or the name of a technical partner maintaining the integration. Shopify, Wallymart 200 chars optional
x-shippit-platform A string identifying the platform/software making the calls. This will help us to identify when all integrations on the same platform require action, or who to contact about known issues with a platform type. Magento v2, CustomShop2000 200 chars Optional, but strongly encouraged

Whilst this information in the request headers is currently optional, it is highly encouraged as it will allow Shippit to better support your integration by helping us to more easily identify which systems are making which API requests, and who to contact with pertinent information about specific integrations and/or platforms.

Was this article helpful?
0 out of 1 found this helpful