Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The interface is part of our standard web service offering and can be found in our swagger documentation.

View file
nameswagger.yaml
height250


Panel
titleTable of Contents

Table of Contents
exclude(Example response)|(Parameters)

...

It is important to note that the commonTitle is mandatory whenever sex is set to MALE or FEMALE if the agency is using Title Structure "Default".
Should you create / update a profile using compoundTitle, you might still get an errorMessage for greeting.commonTitle in case the supplied compoundTitle can not be derived into a valid commonTitle.

Get linked

...

traveler profiles

 

Anchor
TravelerGreetingStructure
TravelerGreetingStructure
Arranger

Scopeapi.profilesondemand.read
Endpointapi/v1/traveller/<uuid>/arranger-contacts
Request methodGET

 

Query returns an array of travellers travelers where the specified uuid is linked as an arranger.

Parameters
NameDescriptionValidation
uuidThe profile UUID for which you want to get a list of travellers where profile is selected as arrangerMandatory parameter
Code Block
languagebash
titleExample request
 curl -v -H "Authorization: Bearer <token>" \
    "https://hurricane.umbrellanet.ch/uf-test/api/v1/traveller/065fe9e0-47b7-4d12-b3de-d3aa38169175/arranger-contacts"
Code Block
languagejs
titleExample response
collapsetrue
[
    {
        "displayText": "Mr. Bob Example",
        "contactUuid": "4cc19e19-11f4-46c3-b4f6-1ee2360a5752"
    },
    {
        "displayText": "Mrs. Jane Never",
        "contactUuid": "9a57f51b-1b7b-43cd-8582-d909670682aa"
    }
]

 

Anchor
TravelerGreetingStructure
TravelerGreetingStructure
Approver

Scopeapi.profilesondemand.read
Endpointapi/v1/traveller/<uuid>/approver-contacts
Request methodGET

Query returns an array of travellers travelers where the specified uuid is linked as an approver.

Parameters
NameDescriptionValidation
uuidThe profile UUID for which you want to get a list of travellers where profile is selected as approverMandatory parameter
Code Block
languagebash
titleExample request
 curl -v -H "Authorization: Bearer <token>" \
    "https://hurricane.umbrellanet.ch/uf-test/api/v1/traveller/065fe9e0-47b7-4d12-b3de-d3aa38169175/approver-contacts"
Code Block
languagejs
titleExample response
collapsetrue
[
    {
        "displayText": "Mr. Bob Example",
        "contactUuid": "4cc19e19-11f4-46c3-b4f6-1ee2360a5752"
    },
    {
        "displayText": "Mrs. Jane Never",
        "contactUuid": "9a57f51b-1b7b-43cd-8582-d909670682aa"
    }
]

Create new traveler profile

...

Create a new traveler profile

Parameters
NameDescriptionValidation
returnAddSectionsList of additional profile sections which should be included in the response, even if not modified by the current operationOptional parameter (GET)

...

Updates (part of) the details of a single traveler profile.

Parameters
NameDescriptionValidation
<uuid>The UUID of the profile to updateRequired parameter
returnAddSectionsList of additional profile sections which should be included in the response, even if not modified by the current operationOptional parameter (GET)

...

Delete a single traveler profile from Faces as well as all downline systems.

Parameters
NameDescriptionValidation
<uuid>The UUID of the profile to deleteRequired parameter

...

Fetch plaintext credit card data from a company or traveler profile.

Parameters
NameDescriptionValidation
uuidOwning (company / traveler) profile UUIDRequired parameter
ccUuid

Specific credit card UUID as obtained from the CREDIT_CARDS section of the profile.

See: Company profile sections overview, Traveler profile sections overview

Required parameter

...

Fetch the generic setup of a travelagency tailored to the access level of the calling user / application

Parameters
NameDescriptionValidation
<uuid>The UUID of the travelagencyRequired parameter
profileType

May be used to restrict the response to configuration for a specific profile type.

OptionalOne of TRAVELLER, CORPORATE

 

...

Fetch the generic setup of a company tailored to the access level of the calling user / application

Parameters
NameDescriptionValidation
<uuid>The UUID of the companyRequired parameter
mergedDefines wheter to include only the company setup (false) or merge it with the underlying agency setup (true)

Boolean value: true or false

Optional, default: false

profileType

May be used to restrict the response to configuration for a specific profile type.

Optional

One of TRAVELLER, CORPORATE

...

Fetch a list of publishing errors

Parameters
NameDescriptionValidation
pageCurrent page within the result set, starts at 0Optional, number >= 0
pageSizeMaximum number of results per page. Default 25Optional, number > 0 and <= 100
sinceRestrict results to errors that have occurred on or after a specific timestampOptional
Format yyyy-MM-dd'T'HH:mm[:ss[.SSS]]X

...

Fetch a list of available frequent flyer options

Parameters
NameDescriptionValidation
profileType

Some options are only available on COPORATE level but no on TRAVELLER profiles.

This parameter allows to query the valid options per profile type

Optional parameter:

  • TRAVELLER
  • CORPORATE

Will return all frequent flyer options (unfiltered) if omitted

...

Fetch a list of known rail card types

Parameters
NameDescriptionValidation
agency

Allows specifying an agency UUID for which the supported rail card types should be listed.

Depending on the agency setup the available types may differ

Optional Parameter

Will return all card types if omitted

...