Update Logs

The Update Log call is used to retrieve update logs, downloadable links of text files containing information on Rates & Availability data updated for existing property for specific date requested.


Endpoint

POST

https://connect-sandbox.su-api.com/SUAPI/jservice/updatelog

Mandatory elements

Element name - request

Description
The request element is the root of every updatelog call.

Type

structural element

Children

n/a

Attribute Name

Attribute
Description

hotelid / hotel_id / ClientID

IT provider's hotel id for which retrieving update log/s.

date

Date for which retrieving update log/s. Must be in YYYY-MM-DD Format

Attribute Name - hotelid / hotel_id / ClientID

Description
IT provider's unique hotel id / Client id.

Type

alphanumeric

Constraints

needs to be a property registered in the STAAH (Existing)

Amount of elements possible within parent

1

Element name - date

Description
Date for which need to retrieve update log/s

Type

datetime

Constraints

Current date or Past date

Amount of elements possible within parent

1

Format

YYYY-MM-DD


Sample Request

Please find an example input message below:

{
  "hotelid": "new1",
  "date": "2018-06-06"
}

Response

Success

{
  "Updatelogs": [
    {
      "hotelid": "new1",
      "date": "2018-06-06",
      "log": "https://s3.amazonaws.com/suissu/updatelog/11/new1/2018-06-06/15282612441755000008810.txt"
    },
    {
      "hotelid": "new1",
      "date": "2018-06-06",
      "log": "https://s3.amazonaws.com/suissu/updatelog/11/new1/2018-06-06/15282615814995000003514.txt"
    },
    {
      "hotelid": "new1",
      "date": "2018-06-06",
      "log": "https://s3.amazonaws.com/suissu/updatelog/11/new1/2018-06-06/152826173312081741762.txt"
    }
  ]
}

Errors

{
  "Status": "Fail",
  "Errors": {
    "Code": "937",
    "ShortText": "No updates found for this date"
  }
}

This error will be given if there is no update log found for the given values.


Errors Due to Invalid Parameters

{
  "Status": "Fail",
  "Errors": {
    "Code": "400",
    "ShortText": "Invalid HotelCode (new)"
  }
}

This error will be received if allocated with incorrect Hotel id / ClientID.

{
  "Status": "Fail",
  "Errors": {
    "Code": "935",
    "ShortText": "Invalid date or format must be 'YYYY-MM-DD'"
  }
}

This error will be received if provided invalid date. The Date format must be YYYY-MM-DD.

{
  "Status": "Fail",
  "Errors": {
    "Code": "936",
    "ShortText": "Date must be past or present"
  }
}

This error will be generated if allocated with any of future date. Update Logs are available for current or past date only.

Last updated

Was this helpful?