Tourmind AI APIs

AI 房型匹配与映射

AI 房型映射

Room Map API 可以汇总并分类特定房源不同供应商的可比客房，处理客房数据并将具有相似属性的客房归类为统一的群组。

如果您没有自维护的标准化房型列表，可以使用 RoomMap API 根据历史数据分析得出一组推荐的标准房型，这是一种有效的房型分类方法。

接口调用信息

名称	值
请求地址	http://developers.tourmind.cn/v2/RoomMap
请求方式	POST

请求字段

PropertyId: string

酒店唯一标识

PropertyName: string

酒店名称

SupplierId: string

供应商唯一标识

RoomId: string

房间唯一标识

RoomName: string

供应商提供的原始房间名称

响应字段

GroupCode: string

房型分组的唯一编码。

GroupName: string

房型分组名称。

RoomIds: string

房间唯一标识。

RoomName: string

分组内单个房间的名称。

SupplierId: string

提供该房间的供应商标识。

PropertyId: string

酒店唯一标识。

PropertyName: string

所引用酒店的名称。

Unmapped[]: any

未能映射的房间或分组列表（如有）。

请求参数

{
  "SupplierList": [
    {
      "SupplierRooms": [
        {}
      ]
    }
  ]
}

响应结果

{
  "Aggregation": [
    {
      "GroupRooms": [
        {}
      ]
    }
  ],
  "Unmapped": []
}

AI 房型匹配

Room Match API 提供智能客房匹配服务，建立参考酒店客房与供应商客房列表之间的关系。通过 AI 算法，它会自动将参考酒店的标准房型与不同供应商提供的客房信息进行匹配。

如果您已经维护了自己的标准化房型，建议使用 Room Match 功能直接利用其精选数据进行精准房型匹配。

接口调用信息

名称	值
请求地址	http://developers.tourmind.cn/v2/RoomMatch
请求方式	POST

请求字段

AppKey: string

EnableDeepThinking: boolean

BedName: string

RoomId: string

RoomName: string

PropertyId: string

PropertyName: string

AgentCode: string

Tourmind为代理商提供的唯一编码

Password: string

API请求的密码

RequestTime: string

请求时间戳，ISO 8601 格式，精确到毫秒，例如： "2006-01-02T15:04:05.123Z"

TransactionID: string

用于跟踪API请求的标识符，例如使用GUID

UserName: string

API请求的用户名

SupplierId: string

SupplierBedName: string

SupplierRoomId: string

SupplierRoomName: string

响应字段

Code: integer

BedName: string

Score: number

SupplierBedName: string

SupplierId: string

SupplierRoomId: string

SupplierRoomName: string

RoomId: string

RoomName: string

PropertyId: string

PropertyName: string

ErrorCode: string

错误代码

ErrorCode	Description
101	请求中没有有效载荷
102	请求的格式无效
103	请求数据验证失败
104	服务错误
105	API 用户身份验证错误, 无效的 AgentCode, 用户名或密码

ErrorMessage: string

错误信息

ResponseTime: string

响应时间戳，格式： “2006-01-02 15:04:05”

TransactionID: string

该值与请求中的TransactionID一致.

Success: boolean

Score: number

SupplierBedName: string

SupplierId: string

SupplierRoomId: string

SupplierRoomName: string

请求参数

{
  "MasterRoomList": [
    {}
  ],
  "PropertyInfo": {},
  "RequestHeader": {
    "AgentCode": "tms_test",
    "Password": "tms_test",
    "RequestTime": "2018-07-26T09:51:32.123Z",
    "TransactionID": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
    "UserName": "tms_test"
  },
  "SupplierRoomList": [
    {
      "SupplierRoomInfo": [
        {}
      ]
    }
  ]
}

响应结果

{
  "Data": {
    "MatchedRooms": [
      {
        "MatchedRooms": [
          {}
        ]
      }
    ]
  },
  "Error": {
    "ErrorCode": "101",
    "ErrorMessage": "invaild param"
  },
  "ResponseHeader": {
    "ResponseTime": "2018-07-26 09:51:32",
    "TransactionID": "6ba7b810-9dad-11d1-80b4-00c04fd430c8"
  },
  "UnmatchedRooms": [
    {}
  ]
}

AI 价格预测

AI 价格预测

价格预测 API 为预测酒店房型未来的价格趋势提供了强大的解决方案。此 API 旨在通过提供特定时间段内各种酒店房型的预期低价和高价范围的洞察，帮助酒店行业的用户和企业做出明智的定价策略决策。

接口调用信息

名称	值
请求地址	http://developers.tourmind.cn/v2/RatePrediction
请求方式	POST

请求字段

CheckIn: string

入住日期（ISO 8601 格式）

CheckOut: string

离店日期（ISO 8601 格式）

CurrencyCode: string

期望的货币代码

City: string

Country: string

HotelName: string

Adults: integer

Children: integer

ChildrenAges[]: integer

RoomCount: integer

响应字段

City: string

酒店所在城市。

Country: string

酒店所在国家。

HotelName: string

酒店名称。

End: string

低价时段结束日期，ISO 8601 格式。

Start: string

低价时段开始日期，ISO 8601 格式。

CurrencyCode: string

价格货币代码（例如 USD、EUR）。

Max: number

低价时段内的最高价格。

Min: number

低价时段内的最低价格。

End: string

低价时段结束日期，ISO 8601 格式。

Start: string

低价时段开始日期，ISO 8601 格式。

CurrencyCode: string

价格货币代码（例如 USD、EUR）。

Max: number

低价时段内的最高价格。

Min: number

低价时段内的最低价格。

RoomName: string

房型名称。

请求参数

{
  "Hotels": [
    {
      "City": "Shanghai",
      "Country": "China",
      "HotelName": "Hilton Shanghai"
    }
  ],
  "PaxRooms": [
    {
      "Adults": 2,
      "ChildrenAges": []
    }
  ]
}

响应结果

{
  "PricePredictions": [
    {
      "HotelInfo": {},
      "RoomTypes": [
        {
          "HighPricePeriods": [
            {
              "DateRange": {},
              "HighPriceRange": {}
            }
          ],
          "LowPricePeriods": [
            {
              "DateRange": {},
              "LowPriceRange": {}
            }
          ]
        }
      ]
    }
  ]
}