Error handlingCopy link

The Lodging Partner GraphQL API responses can contain errors that occur during the different phases of a request (authentication, validation, schema generation, and execution) as well as internal system errors. The following describes the payload of an HTTP GraphQL response:

1{
2  data: { ... },
3  errors: [] // only present if an error occurs
4}

The semantics of the response format as well as more details about the error object content (returned in the errors array) are described in full detail in the GraphQL error spec.

• Rate limit exceeded

  This type of error occurs when you exceed our rate limit at the resource level. An HTTP status code of 200 is returned. (We recommend that you consider throttling your requests.) Here is an example of the error object response format:

  1{
  2  "errors": [
  3    {
  4      "message": "Too many requests, please try again in 1 seconds.",
  5      "path": [
  6        "addMessage"
  7      ],
  8      "extensions": {
  9        "limit": 5,
  10        "duration": 1,
  11        "code": "RATE_LIMIT_EXCEEDED"
  12      }
  13    }
  14  ]
  15}

These status codes are used in response to the HTTP request:

Error classes

If an error is thrown before or during the following, it is associated with the GraphQL request:

• transport of the HTTP request to the server hosting the GraphQL endpoint
• the request phase of the GraphQL lifecycle
• the parse phase of the GraphQL lifecycle
• the validate phase of the GraphQL lifecycle

If an error is during the execute phase of the GraphQL lifecycle, it is associated with the GraphQL execution.

In either case, an error object is returned to the requester. An HTTP or GraphQL request error results in a non-200 status code, while a GraphQL execution error results in a 200 status code. These error classes are defined as follows:

• User input error during GraphQL execution

  This occurs when an input or parameter to a resolver was not in an expected form or did meet parameter requirements. The intention of this type of error is to give the user information about what to change or provide. An HTTP status code of 200 is returned. User input messages include the following:

  • reviews.pageSize: pageSize must be between 0 and 10
  • The cursor is invalid
  • The body locale is invalid
  • The body value is invalid
  • Only a single orderBy field is allowed
  • starRatings category overall is mandatory
  • Invalid rating provided (starRatings values should be positive integer between 1 and 5)

  1{ 
  2  "errors": [ 
  3    { 
  4      "message": "The body locale is invalid", 
  5      "locations": [], 
  6      "path": [ 
  7        "setReviewResponse" 
  8      ], 
  9      "extensions": { 
  10        "code": "BAD_USER_INPUT" 
  11      } 
  12    } 
  13  ], 
  14  "data": { 
  15    "setReviewResponse": null 
  16  }
  17} 

• Authentication error during GraphQL execution

  This occurs when the requesting client needs to be authenticated in order to access the requested data. An HTTP status code of 200 is returned. Here is an example of the error object response format:

  1{ 
  2  "errors": [ 
  3    { 
  4      "message": "Error occurred while requesting status: Failed to get authorization from Supply Access Management.", 
  5      "locations": [ 
  6        { 
  7          "line": 2, 
  8          "column": 3  
  9        } 
  10      ], 
  11      "path": ['property'], 
  12      "extensions": { 
  13        "code": "UNAUTHENTICATED"  
  14      } 
  15    } 
  16  ] 
  17} 

• Forbidden error during GraphQL execution

  This type of error occurs when the requesting client is not permitted to access the requested resource or GraphQL data path. An HTTP status code of 403 is returned. Forbidden error messages include the following:

  • Insufficient Permissions
  • Missing Required Scope

  Here is an example of the error object response format:

  1{
  2  "errors": [
  3    {
  4      "message": "You do not have sufficient rights to access the resource you requested.",
  5      "extensions": {
  6        "code": "FORBIDDEN"
  7      }
  8    }
  9  ],
  10  "data": {
  11    "property": null
  12  }
  13}

• Syntax errors in the GraphQL request

  These occur when the GraphQL operation contains a syntax error. An HTTP status code of 400 is returned. Here is an example of the error object response format:

  1{ 
  2  "errors": [  
  3    { 
  4      "message": "Syntax Error: Unexpected Name "}", 
  5      "locations": [ 
  6         { 
  7           "line": 1, 
  8           "column": 1 
  9         } 
  10      ], 
  11      "extensions": { 
  12         "code": "GRAPHQL_PARSE_FAILED" 
  13      } 
  14    } 
  15  ] 
  16} 

• Validation errors in the GraphQL request

  This type of error occurs when a query is syntactically valid but does not adhere to the restrictions defined by the schema, such as if A required argument was not provided

  • A review response cannot be submitted for the review (THIRD_PARTY_REVIEW, REVIEW_NOT_APPROVED, or VALID_MANAGEMENT_RESPONSE_EXIST)

  • The reservation is not found (RATE_TRAVELER_PARTIAL_BOOKING_NOT_FOUND)

  • The reservation doesn't belong to the API user

  • The reservation is not eligible for a guest rating

  • The review period has expired (REVIEW_PERIOD_EXPIRED)

  • Rating cannot be provided because the reservation has not ended (RESERVATION_NOT_ENDED)

  • The rating period has ended (RATE_TRAVELER_PARTIAL_NO_ELIGIBLE_RESERVATIONS_FOUND)

  • A rating has been submitted (REVIEW_ALREADY_EXISTS)

    An HTTP status code of 200 is returned. Here is an example of the error object response format:

    1{ 
    2  "errors": [ 
    3    { 
    4      "message": "Not allowed to submit review response for this review", 
    5      "locations": [ 
    6        { 
    7          "line": 2, 
    8          "column": 3 
    9        } 
    10      ], 
    11      "extensions": { 
    12        "code": "GRAPHQL_VALIDATION_FAILED"  
    13      } 
    14    }
    15  ]
    16} 

    embedMdx:error_rate_limit.mdx

• Unknown or unsupported resource (data source error)

  If a non-existent resource is requested, such as an advertiser or property that does not exist, an HTTP status code of 200 is returned but the data set is null. Here is an example of the response:

  1{
  2  "errors": [
  3    {
  4      "message": "id: 92tjs932d not found.",
  5      "locations": [
  6        {
  7          "line": 2,
  8          "column": 3
  9        }
  10      ],
  11      "path": [
  12        "property"
  13      ],
  14      "extensions": {
  15        "code": "DATA_SOURCE_ERROR"
  16      }
  17    }
  18  ],
  19  "data": {
  20    "property": null
  21  }
  22}

• Internal server error during GraphQL execution

  This type of error occurs when an error object is thrown from a resolver, when an error could not automatically be remapped to a known error class, or when an internal server error is thrown from a resolver. An HTTP status code of 200 is returned. Here is an example of the error object response format:

  1{ 
  2  "errors": [ 
  3    { 
  4      "message": "Cannot read property 'spfm' of null" 
  5      "locations": [ 
  6        { 
  7          "line": 2, 
  8          "column": 3 
  9        } 
  10     ] 
  11    } 
  12  ], 
  13  "path": ['property'], 
  14  "extensions": { 
  15     "code": "INTERNAL_SERVER_ERROR" 
  16  } 
  17}