Table of Contents

🏨 Hotel Service Documentation

Overview

Hotel Service provides APIs for hotel search, booking management, and metadata retrieval.

Download Postman Collection For Hotel Hub: Download here

🔄 Hotel API Interaction Workflow

Hotel API Interaction Workflow


🚀 Quick Start

  1. Authenticate: Get your API token.
curl --location '{{host}}/connect/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=password' \
--data-urlencode 'client_id=' \
--data-urlencode 'password=@Password123' \
--data-urlencode 'username=account@tripdata.vn'

Parameter Required Description
grant_type ✅ Yes Must be password
client_id ✅ Yes Client application identifier
username ✅ Yes User's email/username
password ✅ Yes User's password

Authentication Details | Error Handling

  1. API Endpoint:

    • URL: {{host}}/{path}
    • Method: POST
    • Content-Type: application/json
  2. Explore APIs:


🔑 Core Features

Feature Description Documentation
Search Destinations & Hotels Search and place new hotel bookings API Document
Search Booking View and manage hotel booking details API Document
Search City Feeds Retrieve hotel and city metadata API Document

🗂️ API Structure

graph TD
  A[Hotel Service] --> B(Booking)
  A --> C(Manage Booking)
  A --> D(Hotel Metadata)
  B --> E[/POST /search_hotels📝/]
  C --> F[/POST /search_booking📝/]
  D --> G[/GET /b2c/*ℹ️/]

  click B "booking/search_hotels.html" "View Booking APIs"
  click C "manage-booking/get_booking_by_id.html" "View Manage Booking APIs"
  click D "metadata/overview_metadata.html" "View Metadata APIs"
  click E "booking/search_hotels.html" "View Search Hotels"
  click F "manage-booking/search_booking.html" "View Search Booking"
  click G "metadata/overview_metadata.html" "View Metadata"

🌟 Use Cases

  • Instantly search and book hotels for your customers.
  • Manage and track hotel bookings.
  • Retrieve metadata for hotels and supported cities.