API Request Headers
Updated over a week ago

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

To assist the 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.

Did this answer your question?