Introduction

The purpose of this document is to provide technical details about the API's. This document outlines the business processes supported by the API and details about specifications of API’s. It assumes that reader has a technical background and is familiar with JSON, API's.

Connection properties

The communication with the system is performed through http connections. The following table enlists the properties of the request that must be employed:

RequestValueDescription
Request MethodPOSTThe requested method.
Content-Typeapplication/jsonThe content type.

Request/Response

It is recom mended that at least all booking and cancellation transactions sent through the Test / Live environment should be logged and maintained by the hotel agent for at least 6 months.

Go-Test/Live Process

In order to start testing, please notify our support team via e - mail at bedlinkerapi@technoheaven.com

When you have completed your development, contact your Account Manager for the activation of the access IP address of Test/Live Server i s essential for whitelisting

Client Requirements

  • Client requests must be issued from a public, static IP address registered with System.
  • Client requests must be made via an HTTPS POST request.
  • SSL.
  • All data sent and received via the interface will be encoded in UTF-8.

Development Phase

Once you receive your Access token, you can start the development of your application/framework. The whole process of communication consists of simple JSON messages exchange (request /response) between your applic ation/framework and system. Each request needs to be posted (through POST method) using https protocols. For details regarding requests and answers formats please consult the dedicated area of each request. For further assistance in development process do not hesitate to contact our support team.

Implementation Approach

  1. Client review of the API specifications
    1. Review of API specifications
  2. Test Environment Integration
    1. API Integration
    2. Test Execution by your Tech Team
  3. Integration Testing
    1. Determining the necessary test cases based on the API's by Our Tech Team
    2. Test Execution.
    3. Certification by Our Tech Team
  4. Production Environment
    1. API Integration
    2. Schedule Go Live Date
    3. Transaction Monitoring and Issue Resolution

Documentation and Downloads

Status & Error Code

NoStatus CodeDescription
1200OK
2400Bad Request
3401Unauthorized
4403Forbidden
5404Not Found
6500Internal Server Error
7503Service Unavailable

Image Path

Date Format

  • Date format send to Payload MM/DD/YYYY

Getallcountrys

The getallcountrys API has been designed to provide All Countries data. The following sections describe the getallcountrys API Request and Response Format.

The Request URL :

http://testapi.technoheaven.com/api/Hotel/GetHotelAPIDetails

JSON Request Format:


TagDescriptionOptionality
ApiNameApiName is the key factorMandatory
tokenYou have to put unique token which is provided by the systemMandatory

JSON Response Format:

Example:-

"CountryID": "15442"
"GroupValue":"Malaysia"

TagDescription
CountryIdString representing unique CountryId.
Group ValueString representing Group Value

Get All Citys

The getallcitys API has been designed to provide All City’s data for particular Country . The following section describes the getallcitys API Request and Response Format .

The Request URL:

http://testapi.technoheaven.com/api/Hotel/GetHotelAPIDetails

JSON Request Format:-


Parent TagTagDescriptionOptionality
ApiNameApiNameApiName is the key factorMandatory
payloadCountryIdString representing unique CountryIdMandatory
TokenTokenYou have to put unique token which is provided by the systemMandatory

JSON Response Format:-

Example:-

"CityId":20097
"City": "Kuala Lumpur"

TagDescription
CityIdAn Integer representing unique CityId.
CityIdAn Integer representing unique CityId.

Hotel List Search

The hotellistsearch API has been designed to provide list of all Hotels with display minimum price for particular hotel. The following sections describe the hotellistsearch API request and response format.

The Request URL:

http://testapi.technoheaven.com/api/Hotel/GetHotelAPIDetails

JSON Request format:-


Parent TagTagDescriptionOptionality
ApiNameApiNameApiName is the key factor.Mandatory
payload RoomsMandatory
RoomsNoString representing RoomNoMandatory
NoofAdultsString representing age of NoofAdultsMandatory
NoOfChildString representing number of child.Mandatory
Child1AgeString representing Age of 1st Childs.Optional
Child2AgeString representing age of 2nd child.Optional
CityIDString representing unique CityID.Mandatory
NationalityString representing unique Nationality.Mandatory
CheckInDateString representing
CheckInDate.
Date should be in the format:
MM-DD-YYYY
Example: 08-12-2018
Mandatory
CheckOutDateString representing
CheckOutDate.
Date should be in the format:
MM-DD-YYYY
Example: 08-12-2018
Mandatory
NoofNightsString representing number of NightsMandatory
StarStartString representing StarStartMandatory
StarEndString representing StarEnd./td>Mandatory
tokentokenYou have to put unique token which is provided by the system./td>Mandatory

JSON Response format:-


Parent TagTagDescription
HotelResultHotelIdAn Integer representing unique HotelId.
SellingPriceAn Integer representing unique SellingPrice.
BeforeDiscPriceAn Integer representing BeforeDiscPrice.
AvailTokenIt display unique AvailToken which is provided by the system.
RecommendedHotelString representing RecommendedHotel separated by comma (,).

Get Hotel Mapping Data

The hotelmapping API has been designed to returns few information of the hotels as describing below. The following section describes the hotelmapping API Request and Response Format.

The Request URL:

http://testapi.technoheaven.com/api/Hotel/GetHotelAPIDetails

JSON Request format:-


Parent TagTagDescriptionOptionality
ApiNameApiNameApiName is the key factorMandatory
payloadCityIdString representing unique CityId.Mandatory
tokentokenYou have to put unique token which is provided by the system.Mandatory

JSON Response format:-


Parent TagTagDescription
HotelDetailsHotelIdAn Integer representing unique HotelId.
HotelNameString representing unique HotelName
latString representing unique lat
logString representing unique log
AddressString representing unique Address
RatingString representing unique Rating
imgString representing unique image url

Hotellistdetails

The hotellistdetails API has been designed to provide details of Hotel.The following section describes the hotellistdetails API Request and Response Format.

http://testapi.technoheaven.com/api/Hotel/GetHotelAPIDetails

JSON Request Format:-


Parent TagTagDescriptionOptionality
ApiNameApiNameApiName is the key factorMandatory
payloadHotelIdString representing unique Id for particular HotelMandatory
tokentokenYou have to put unique token which is provided by the systemMandatory

JSON Response Format:-


Parent TagTagDescription
DescriptionTypeString representing Type.
Report_TextString representing some_description.
HotelImagesImagePathString representing unique Image URL.
HotelfacilitiesComplementaryNameString representing ComplementaryName
ComplementaryTextString representing ComplementaryText.
ImagePathString representing unique Image URL.

HotelRoomDetais

The hotel roomdetails API has been designed to provide details of Room s for particular hotel. The following sections describe the hotelroomdetails API request and response format.

The Request URL:

http://testapi.technoheaven.com/api/Hotel/GetHotelAPIDetails

JSON Request format:-


Parent TagTagDescriptionOptionality
APINameAPINameAPIName is the key factorMandatory
payloadRoomsArray representing Rooms
RoomNoString representing RoomNoMandatory
NoofAdultsString representing number of adults.Mandatory
NoOfChildString representing number of Child.Mandatory
Child1AgeString representing age of 1st Child.Optional
Child2AgeString representing age of 2nd ChildOptional
CityIDString representing unique CityIDMandatory
NationalityString representing unique Nationality.Mandatory
CheckInDateString representing CheckInDate.
Date should be in the format:
MM-DD-YYYY
Example: 08-12-2018
Mandatory
CheckOutDateString representing CheckOutDate.
Date should be in the format:
MM-DD-YYYY
Example: 08-12-2018
Mandatory
NoofNightsAn Integer representing NoofNightsMandatory
HotelRoomSearchHotelIDString representing unique HotelIDMandatory
HitHit logic “0”, “1”, and “2” is used for Show More data.Mandatory
AvailTokenYou have to put unique AvailToken which is provided by the system.Mandatory
tokentokenYou have to put unique token which is generated by the systemMandatory

JSON Response format:-


Parent TagTagDescription
HotelRoomDetailsListRoomNoAn Integer representing unique RoomNo
RoomTypeNameString representing unique RoomTypeName
MealNameString representing unique MealName
FinalSellingPriceIt is display Final Price of Selling
GrossWithoutDiscountString representing GrossWithoutDiscount
EssentialInformationString representing EssentialInformation
BookingStatusString representing BookingStatus
IsPolicyDynamicDoes this Policy Dynamic for Particular Hotel.Boolean field: True or False.
IsCombineRoomDoes this combined Room. Boolean field: True or False.
LoyaltyPointsAn Integer representing LoyaltyPoints
LoyaltyPointsIconString representing unique LoyaltyPointsIcon.
RoomTokenIt display unique token for Room which is provided by the system.
MealTokenIt display unique token for Meal which is provided by the system.
OtherTokenIt displays unique OtherToken which is provided by the system.
CancellationPoicyFromDateString representing FromDate.
Date should be in the format:
MM-DD-YYYY
Example: 08-12-2018
ToDateString representing ToDate.
Date should be in the format:
MM-DD-YYYY
Example: 08-12-2018
AgentCancellationPriceString representing cancellation Price for particular Agent
CancellationTokenIt display unique token for cancellation which is provided by the system.
RoomRateDateString representing Date.
Date should be in the format:
MM-DD-YYYY
Example: 08-12-2018
DateOfWeekString representing name of day in week for particular date.
RateString representing unique Rate
BookingStatusString representing BookingStatus
RateTypeString representing unique RateType
RoomTypeNameString representing unique RoomTypeName
RoomRateDeatailTokenIt display unique token for RoomRateDetail which is provided by the system.

Contact Us

In order to start testing / Live please notify our support team via e-mail at bedlinkerapi@technoheaven.com

General Terms and conditions
Privacy Policy
SEARCH NOW

Notification

×

SEARCH NOW

×