Content (In Member Review)

Adds extra content fields to OCTO Core object schemas on select endpoints to provide detailed descriptive information about supplier, products, options, units, booking, etc.

PreviousNotifications NextPickups (Proposed Draft)

Last updated 14 days ago

Localization

Since suppliers and their systems may offer content in different languages, this content capability supports localization through Accept-Language request header as well as Content-Language and Available-Languages response headers as described below.

Request Headers

Header

Required

Description

Response Headers

Header

Required

Additional Content Fields

Content capability enriches existing OCTO Core Supplier, Product, Option, Unit, Availability and Booking objects with additional information listed below when octo/content is added to the Octo-Capabilities header of the request of any OCTO Core endpoint containing this object, given that the supplier system supports this capability.

Please select a tab below to view exact fields and details for each object:

Supplier object will be extended with additional information about the supplier as indicated below.

Please note introduction of an optional venue concept. venue object, whose fields mostly repeat supplier ones, is designed for larger suppliers that operate multiple locations, venues, brands or destinations that may need to have different more specific supplier content information, as show in example below. Working draft in Google Sheets: https://docs.google.com/spreadsheets/d/12bAjNcmW92ZIsghLNfDlpuZALzO7GLkOODWrocu3sic/edit?gid=478235837#gid=478235837

{
  
// ...rest of the Supplier object

  "name": "Merlin Entertainments", // existing OCTO Core field
  "contact": {
    "website": "https://www.merlinentertainments.biz/", // existing OCTO Core field
    "email": "info@merlinentertainments.biz", // existing OCTO Core field
    "telephone": "+441202666900", // existing OCTO Core field
    "address": "Link House, 25 West St, Poole BH15 1LD, United Kingdom", // existing OCTO Core field
    "addressLine1": "25 West St",
    "addressLine2": "Link House",
    "city": "Poole",
    "stateProvinceRegion": null,
    "postalCode": "BH15 1LD",
    "country": "GB",
    "latitude": "50.715719",
    "longitude": "-1.9877584",
    "externalPlatformLocations": [
      {
        "type": "googlePlaceId",
        "id": "ChIJBbs_ce-mc0gROKH33v3tq4k",
        "name": "Merlin Entertainments",
        "url": "https://www.google.com/maps/place/?q=place_id:ChIJBbs_ce-mc0gROKH33v3tq4k"
      }
    ]
  },
  "legalName": "Merlin Entertainments Group Limited",
  "shortDescription": "Merlin Entertainments is the global leader in branded entertainment destinations. We create and deliver memorable, immersive brand experiences for over 60 million guests every year. Merlin Entertainments has over 140 attractions worldwide, ranging from indoor attractions such as SEA LIFE and Madame Tussauds to iconic theme parks like LEGOLAND and Alton Towers Resort.",
  "logoImages": [
    {
      "url": "https://www.merlinentertainments.biz/media/1399/logo-blue.png",
      "copyright": "The logo cannot be modified without express permission from Merlin Entertainments."
    }
  ],
  "socialMedia": [
    {
      "platform": "facebook",
      "url": "https://www.facebook.com/MerlinEntertainments/",
      "username": null,
      "profileId": "MerlinEntertainments"
    }
  ],
  "additionalContacts": [
    {
      "fullName": "John Doe",
      "role": "Head of Global Travel Trade",
      "type": ["sales", "other"],
      "telephone": "+441202666903",
      "email": "john.doe@merlinentertainments.biz"
    }
  ],
  "venues": [
    {
      "id": "38133688-ff33-4b57-8d8a-328d350b913b",
      "name": "lastminute.com London Eye",
      "contact": {
        "website": "https://www.londoneye.com/",
        "email": "reservations@londoneye.com",
        "telephone": "+442079678021",
        "address": "Riverside Building, County Hall, London SE1 7PB, United Kingdom",
        "addressLine1": "Riverside Building",
        "addressLine2": "County Hall",
        "city": "London",
        "stateProvinceRegion": null,
        "postalCode": "SE1 7PB",
        "country": "GB",
        "latitude": 51.5031864,
        "longitude": -0.1195192,
        "externalPlatformLocations": [
          {
            "type": "googlePlaceId",
            "id": "ChIJc2nSALkEdkgRkuoJJBfzkUI",
            "name": "lastminute.com London Eye",
            "url": "https://google.com/maps/place/?q=place_id:ChIJc2nSALkEdkgRkuoJJBfzkUI"
          }
        ]
      },
      "legalName": "London Eye Management Services Limited",
      "shortDescription": "The London Eye, or the Millennium Wheel, is a cantilevered observation wheel on the South Bank of the River Thames in London. It is Europe's tallest cantilevered observation wheel, and the most popular paid tourist attraction in the United Kingdom with over three million visitors annually.",
      "logoImages": [
        {
          "url": "https://www.londoneye.com/media/zn5p2sok/lastminute-com_london_eye_logo_stg05_380x138px.png",
          "copyright": "The logo cannot be modified without express permission from Merlin Entertainments."
        }
      ],
      "socialMedia": [
        {
          "platform": "facebook",
          "url": "https://www.facebook.com/LondonEye/",
          "username": null,
          "profileId": "LondonEye"
        }
      ],
      "additionalContacts": [
        {
          "fullName": "Jimmy Simple",
          "role": "Sales Manager",
          "type": ["sales", "technical"],
          "telephone": "+441202656903",
          "email": "jimmy.simple@merlinentertainments.biz"
        }
      ]
    }
  ]
}