Common Headers

All Air APIs require specific information to be sent in the header of every request. Some requests require additional information.

In this topic:

• Required Header Fields for all Air APIs
• Additional Header Fields for Specific Air APIs

Required Header Fields for all Air APIs

Travelport recommends as best practice that all the following header fields be sent with all requests:

• Accept-Encoding: gzip, deflate
• Cache-Control: no-cache
• Accept: application/json
• Content-Type: application/json
• Authorization: Bearer token from the generated Oauth token.
• XAUTH_TRAVELPORT_ACCESSGROUP: Each PCC is associated with a unique access group. Your PCC and access group are included in the welcome letter sent when you are provisioned for any Travelport JSON APIs.

The following headers are required in only some functions; refer to Additional Header Fields below.

• Accept-Version: Version number of the API, e.g., 9, 9_1
• Content-Version: Version number of the API, e.g., 9, 9_1

The following example shows the data required for version 9; substitute the version number of the APIs you are provisioned for:

Accept: application/json

Content-Type: application/json

XAUTH_TRAVELPORT_ACCESSGROUP: PCCAccessGroup123ABC

Accept-Version: 9

Content-Version: 9

Authorization: Bearer eyJhbGciOiJkaXIiLCJlbmMiOiJBMTI4Q0JDLUhTMjU2IiwianRpIjoiOGc5OTY4bWR2NGVrIn0..DP1oBM-nztJRWZm1Mni88g

Note that the following fields are returned by the Air APIs in the response headers. No customer action with these is necessary:

• Date: Returned in GMT
• Content-Type: application/json
• E2ETrackingId: Unique identifier returned for every transaction
• Content-version: 9, 9_1(version number of the API)
• Vary: accept-encoding
• Content-Encoding: gzip
• Transfer-Encoding: chunked

Additional Header Fields for Specific Air APIs

In addition to the header fields above, the Accept-Version and Content-Version header fields are required only for the following API functions and resources as marked with X. If a column is blank that indicates the field does not need to be populated.