Developers


Introduction
Zodomus is a channel manager API created to provide easy and affordable access to OTA's (Online Travel Agencies, like Booking, Expedia and Airbnb).

A channel manager is a tool that allows access to Rates, Availability and Bookings from any connected channel.

To use Zodomus in production you will need to have previous access to OTA properties and to associate Zodomus as a channel manager in some OTA's or provide us your autentication data to access the OTA's (depends on the OTA's channel manager proceedings).

However you can test Zodomus and prepare your code using our sandbox until you have access to real properties in OTA's.

In the future Zodomus will provide more OTA functions like Content, Promotions, Images and Guest communications as provided by the OTA's.

Zodomus is a Booking certified partner.

We will provide access to Expedia and Airbnb as soon as possible.
Other OTA's will be available soon.

Get started
Registration and access to our sandbox for testing is free.
After registration you get immediate access to Zodomus backoffice.
On the development tab you can get your API Keys to start testing our API functions.
All available API functions can and should be used in test mode.
You can also manually create reservations to use in test mode.
A list of Zodomus API's

Account API's

Access account data and list of channels

Operation Description
GET /account

Get account information

GET /channels

Get a list of current active channels

Config API's

Configure access to channel manager properties, rooms and rates

Operation Description
POST /property-activation

Activate a channel property with Zodomus

POST /property-cancellation

Cancel a channel property with Zodomus

POST /property-check

Check a property with Zodomus

POST /rooms-activation

Activate the property rooms and rates and map them with Zodomus

POST /rooms-cancellation

Cancel property rooms associated with Zodomus

Channel API's

Channel manager API functions

Operation Description
GET /room-rates

Get a list of rooms and rates for the corresponding channel / property

GET /availability

Get the rooms availability for the corresponding channel / property / dates

POST /availability

Set your availability in the defined channel / property / room

GET /reservations-queue

Get a list of reservations

GET /reservations

Get a reservation

GET /reservations-cc

Get a reservation credit card info.

GET /reservations-summary

Get a list of future reservations

POST /rates

Set rates for your channel / property / room /rate

POST /rates-derived

Set rates (derived) for your channel / property / room /rate

POST /reservations-createtest

Create a test reservation for your test property (only used in tests)

It's easy to use our API's
Zodomus API's are REST API's with JSON requests and responses.
On the API reference, available after registration, you can get a detailed reference for each API.

Our API endpoint is : https://api.zodomus.com

All your API calls must use HTTPS and TLS 1.2
Zodomus uses Basic Authentication, with the API User and API Password keys provided in the backoffice.

Let's see some examples to call one simple API : https://api.zodomus.com/channels, to get a list of active channels.

curl:
                                        
                    curl -u api_key_user:api_key_password -i -H 'Accept:application/json' https://api.zodomus.com/channels
                    
                    
Guzzle (Http client for PHP):
                    
                      $credentials = base64_encode($api_key_user.":".$api_key_password);
$client = new GuzzleHttp\Client();
$url="https://api.zodomus.com/channels";
$response = $client->request('GET',$url, [
'headers' => [
'Authorization' => ['Basic '.$credentials],
'Content-type' => 'application/json; charset=UTF8'
]
]);
Python:
                                            
                      import requests
from requests.auth import HTTPBasicAuth
r = requests.post('https://api.zodomus.com/channels', auth=HTTPBasicAuth('api_key_user', 'api_key_password'))
C#:
                                            
                      WebRequest req = WebRequest.Create(@"https://api.zodomus.com/channels");
                      req.Method = "GET";
                      req.Headers["Authorization"] = "Basic " + Convert.ToBase64String(Encoding.Default.GetBytes("api_key_user:api_key_password"));
                      HttpWebResponse resp = req.GetResponse() as HttpWebResponse;
                      
                      

If you need support with any programming language, please send an email to our support.
Unlimited access to our API's during tests
You can use Zodomus sandbox for as long as you need.
You can also access all our API's and prepare your App to production.
Our support team is available during tests if you need.
Access to production
To get access to production you need to have tested all API's in test mode with no errors at least once.
You also need to pass our certification tests in order to go to production.
To pass our certification you should call our support so that we can follow with you all the steps needed to pass certification.
You can find more information about certification and access to production after registration.
PCI complaince and security
Anyone involved with the processing, transmission or storage of credit card data must comply with the Payment Card Industry Data Security Standards (PCI DSS).

Zodomus is PCI DSS compliant to store credit card data.

PCI compliance is a shared responsibility and applies to both Zodomus and your business.
If you are not PCI DSS compliant you should not store card data in your system, you should use Zodomus to access card data and not store it.
All our users must validate their PCI compliance if they need to access credit card data in Production.
If you don't store card data, usually you can do this with a Self-Assessment Questionnaire (SAQ) provided by the PCI Security Standards Council.

If you need any help regarding security call our support team.

Your API calls must use HTTPS and a modern version of TLS (TLS 1.2 or bigger).
You get can a free certificate at Let's Encrypt or any other provider. TLS can be easily setup if you are a developer, but if you need help, please call our support.
You can check your SSL security using Qualys SSL Labs to make sure you have everything set up in a secure way.
More information and support
More information and an API reference with all API's is available after registration in our backoffice.
Support is available during tests and production.