Introduction

The purpose of this document is to provide technical details about the API's. BedLinker provides the smart Hotel API distribution for your website to integrate with huge inventory of hotels and resorts. 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:

Request	Value	Description
Request Method	POST	The requested method.
Content-Type	application/json	The 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

Client review of the API specifications

Review of API specifications

Test Environment Integration

API Integration
Test Execution by your Tech Team

Integration Testing

Determining the necessary test cases based on the API's by Our Tech Team
Test Execution.
Certification by Our Tech Team

Production Environment

API Integration
Schedule Go Live Date
Transaction Monitoring and Issue Resolution

Documentation and Downloads

Status & Error Code

No	Status Code	Description
1	200	OK
2	400	Bad Request
3	401	Unauthorized
4	403	Forbidden
5	404	Not Found
6	500	Internal Server Error
7	503	Service Unavailable

Image Path

Root URL:BaseCDNURL
ImagePath:/Images/Dubai/5104/1-ThumbNail.jpg
CompleteUR:BaseCDNURL/Images/Dubai/5104/1-ThumbNail.jpg

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:

{ "ApiName": "getallcountrys", "token": "token" }

Tag	Description	Optionality
ApiName	ApiName is the key factor	Mandatory
token	You have to put unique token which is provided by the system	Mandatory

JSON Response Format:

{ "CountryId": "Id", "GroupValue": "GroupValue" } { "CountryId": "Id", "GroupValue": "GroupValue" }

Example:-

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

Tag	Description
CountryId	String representing unique CountryId.
Group Value	String 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:-

{ "ApiName": "getallcitys", "payload": { "CountryId": "Id" }, "token": "token" }

Parent Tag	Tag	Description	Optionality
ApiName	ApiName	ApiName is the key factor	Mandatory
payload	CountryId	String representing unique CountryId	Mandatory
Token	Token	You have to put unique token which is provided by the system	Mandatory

JSON Response Format:-

{ "CityId": Id, "city": "city" }, { "CityId": Id, "city": "city" }

Example:-

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

Tag	Description
CityId	An Integer representing unique CityId.
CityId	An 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:-

{ "ApiName": "hotellistsearch", "payload": { "Rooms": [ { "RoomNo": "RoomNo", "NoofAdults": "NoofAdults", "NoOfChild": "NoOfChild", "Child1Age": "Child1Age", "Child2Age": "Child2Age" } ], "CityID": "CityID", "Nationality": "Nationality", "CheckInDate": "CheckInDate", "CheckOutDate": "CheckOutDate", "NoofNights": "NoofNights", "StarStart": "StarStart", "StarEnd": "StarEnd" }, "token": "token" }

Parent Tag	Tag	Description	Optionality
ApiName	ApiName	ApiName is the key factor.	Mandatory
payload	Rooms		Mandatory
	RoomsNo	String representing RoomNo	Mandatory
	NoofAdults	String representing age of NoofAdults	Mandatory
	NoOfChild	String representing number of child.	Mandatory
	Child1Age	String representing Age of 1st Childs.	Optional
	Child2Age	String representing age of 2nd child.	Optional
	CityID	String representing unique CityID.	Mandatory
	Nationality	String representing unique Nationality.	Mandatory
	CheckInDate	String representing CheckInDate. Date should be in the format: MM-DD-YYYY Example: 08-12-2018	Mandatory
	CheckOutDate	String representing CheckOutDate. Date should be in the format: MM-DD-YYYY Example: 08-12-2018	Mandatory
	NoofNights	String representing number of Nights	Mandatory
	StarStart	String representing StarStart	Mandatory
	StarEnd	String representing StarEnd./td>	Mandatory
token	token	You have to put unique token which is provided by the system./td>	Mandatory

JSON Response format:-

{ "HotelResult": [ { "HotelId": HotelId, "SellingPrice": SellingPrice, "BeforeDiscPrice": BeforeDiscPrice, "AvailToken": "AvailToken" } ], "RecommendedHotel": "RecommendedHotel" }

Parent Tag	Tag	Description
HotelResult	HotelId	An Integer representing unique HotelId.
	SellingPrice	An Integer representing unique SellingPrice.
	BeforeDiscPrice	An Integer representing BeforeDiscPrice.
	AvailToken	It display unique AvailToken which is provided by the system.
	RecommendedHotel	String 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:-

{ "ApiName": "hotelmapping", "payload": { "CityId": "CityId" }, "token": "token" }

Parent Tag	Tag	Description	Optionality
ApiName	ApiName	ApiName is the key factor	Mandatory
payload	CityId	String representing unique CityId.	Mandatory
token	token	You have to put unique token which is provided by the system.	Mandatory

JSON Response format:-

{ "HotelDetails": [ { "HotelId": HotelId, "HotelName": "HotelName", "lat": " lat ", "log": " log ", "Address": "Address ", "Rating": "Rating ", "img": "img" } ] }

Parent Tag	Tag	Description
HotelDetails	HotelId	An Integer representing unique HotelId.
	HotelName	String representing unique HotelName
	lat	String representing unique lat
	log	String representing unique log
	Address	String representing unique Address
	Rating	String representing unique Rating
	img	String 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:-

{ "ApiName": "hotellistdetails", "payload": { "HotelId": "HotelId" }, "token": "token" }

Parent Tag	Tag	Description	Optionality
ApiName	ApiName	ApiName is the key factor	Mandatory
payload	HotelId	String representing unique Id for particular Hotel	Mandatory
token	token	You have to put unique token which is provided by the system	Mandatory

JSON Response Format:-

{ "Description": [ { "Type": "Type ", "Report_Text": "some_Description" } ], "HotelImages": [ { "ImagePath": "ImagePath" } ], "Hotelfacilities": [ { "ComplementaryName": "ComplementaryName ", "ComplementaryText": "ComplementaryText ", "ImagePath": "ImagePath" } ] }

Parent Tag	Tag	Description
Description	Type	String representing Type.
	Report_Text	String representing some_description.
HotelImages	ImagePath	String representing unique Image URL.
Hotelfacilities	ComplementaryName	String representing ComplementaryName
	ComplementaryText	String representing ComplementaryText.
	ImagePath	String 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:-

{ "APIName": "hotelroomdetails", "payload": { "Rooms": [ { "RoomNo": "RoomNo", "NoofAdults": "NoofAdults", "NoOfChild": "NoOfChild", "Child1Age": "Child1Age", "Child2Age": "Child2Age" } ], "CityID": "CityID", "Nationality": "Nationality", "CheckInDate": "CheckInDate", "CheckOutDate": "CheckOutDate", "NoofNights": NoofNights }, "HotelRoomSearch": { "HotelID": "HotelID", "Hit": "Hit", "AvailToken": "AvailToken" } } "token": "token" }

Parent Tag	Tag	Description	Optionality
APIName	APIName	APIName is the key factor	Mandatory
payload	Rooms	Array representing Rooms
	RoomNo	String representing RoomNo	Mandatory
	NoofAdults	String representing number of adults.	Mandatory
	NoOfChild	String representing number of Child.	Mandatory
	Child1Age	String representing age of 1st Child.	Optional
	Child2Age	String representing age of 2nd Child	Optional
	CityID	String representing unique CityID	Mandatory
	Nationality	String representing unique Nationality.	Mandatory
	CheckInDate	String representing CheckInDate. Date should be in the format: MM-DD-YYYY Example: 08-12-2018	Mandatory
	CheckOutDate	String representing CheckOutDate. Date should be in the format: MM-DD-YYYY Example: 08-12-2018	Mandatory
	NoofNights	An Integer representing NoofNights	Mandatory
HotelRoomSearch	HotelID	String representing unique HotelID	Mandatory
	Hit	Hit logic “0”, “1”, and “2” is used for Show More data.	Mandatory
	AvailToken	You have to put unique AvailToken which is provided by the system.	Mandatory
token	token	You have to put unique token which is generated by the system	Mandatory

JSON Response format:-

{ "HotelRoomDetailsList": [ [ { "RoomNo": "RoomNo", "RoomTypeName": "RoomTypeName", "MealName": "MealName", "FinalSellingPrice": "FinalSellingPrice", "GrossWitohutDiscount": "GrossWitohutDiscount ", "EssentialInformation": "EssentialInformation", "BookingStatus": "BookingStatus", "IsPolicyDynamic": IsPolicyDynamic, "IsCombineRoom": IsCombineRoom, "LoyaltyPoints": LoyaltyPoints, "LoyaltyPointsIcon": "LoyaltyPointsIcon", "RoomToken": "RoomToken", "MealToken": MealToken, "OtherToken": "OtherToken", "CancelationPoicy": [ { "FromDate": "FromDate", "ToDate": "ToDate", "AgentCancellationPrice": "AgentCancellationPrice ", "CancellationToken": "CancellationToken" } ], "RoomRate": [ { "Date": "Date", "DateOfWeek": "DateOfWeek", "Rate": "Rate", "BookingStatus": BookingStatus, "RateType": "RateType", "RoomTypeName": "RoomTypeName", "RoomRateDetailsToken": "RoomRateDetailsToken" } ] } ] ] }

Parent Tag	Tag	Description
HotelRoomDetailsList	RoomNo	An Integer representing unique RoomNo
	RoomTypeName	String representing unique RoomTypeName
	MealName	String representing unique MealName
	FinalSellingPrice	It is display Final Price of Selling
	GrossWithoutDiscount	String representing GrossWithoutDiscount
	EssentialInformation	String representing EssentialInformation
	BookingStatus	String representing BookingStatus
	IsPolicyDynamic	Does this Policy Dynamic for Particular Hotel.Boolean field: True or False.
	IsCombineRoom	Does this combined Room. Boolean field: True or False.
	LoyaltyPoints	An Integer representing LoyaltyPoints
	LoyaltyPointsIcon	String representing unique LoyaltyPointsIcon.
	RoomToken	It display unique token for Room which is provided by the system.
	MealToken	It display unique token for Meal which is provided by the system.
	OtherToken	It displays unique OtherToken which is provided by the system.
CancellationPoicy	FromDate	String representing FromDate. Date should be in the format: MM-DD-YYYY Example: 08-12-2018
	ToDate	String representing ToDate. Date should be in the format: MM-DD-YYYY Example: 08-12-2018
	AgentCancellationPrice	String representing cancellation Price for particular Agent
	CancellationToken	It display unique token for cancellation which is provided by the system.
RoomRate	Date	String representing Date. Date should be in the format: MM-DD-YYYY Example: 08-12-2018
	DateOfWeek	String representing name of day in week for particular date.
	Rate	String representing unique Rate
	BookingStatus	String representing BookingStatus
	RateType	String representing unique RateType
	RoomTypeName	String representing unique RoomTypeName
	RoomRateDeatailToken	It 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

Introduction

Connection properties

Request/Response

Go-Test/Live Process

Client Requirements

Development Phase

Implementation Approach

Documentation and Downloads

Status & Error Code

Image Path

Date Format

Getallcountrys

The Request URL :

JSON Request Format:

JSON Response Format:

Get All Citys

The Request URL:

JSON Request Format:-

JSON Response Format:-

Hotel List Search

The Request URL:

JSON Request format:-

JSON Response format:-

Get Hotel Mapping Data

The Request URL:

JSON Request format:-

JSON Response format:-

Hotellistdetails

JSON Request Format:-

JSON Response Format:-

HotelRoomDetais

The Request URL:

JSON Request format:-

JSON Response format:-

Contact Us

Subscribe to our Newsletter