User Tools

Site Tools


ors-soap-api:public:json_api

ORS JSON API

You can now also use our new JSON API. It is very similar to SOAP request, but you don't need SOAP client anymore, instead you can simply send JSON requests to our API url.

Post URL: http://api.ors.si/crs/json

PHP Example

# JSON search region request example

{
  "requestType":"search",
  "action":"regions",
  "search":{
    "typ":"hotel",
    "vnd":"2018-01-10",
    "bsd":"2018-03-10",
    "tdc":"1-5",
    "epc":"2"
  },
  "top":{
    "toc":"FTI",
    "stc":"3"
  },
  "header":{
    "lang":"[lang-code]",
    "usr":"[username]",
    "pass":"[password]",
    "agid":"[agency-id]"
  }
}
// PHP cURL post example
 
$data_string = 'json-request-string';
 
$ch = curl_init('http://api.ors.si/crs/json');
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");                                                                     
curl_setopt($ch, CURLOPT_POSTFIELDS, $data_string);                                                                  
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);                                                                      
curl_setopt($ch, CURLOPT_HTTPHEADER, array(                                                                          
    'Content-Type: application/json;charset=utf-8',                                                                                
    'Content-Length: ' . strlen($data_string))                                                                       
);                                                                                                                   
 
$result = curl_exec($ch);
echo $result;

Online Tester

You can also use this online tester to test your requests:

http://api.ors.si/test/

Requests

Each basic request consist of the following attributes:

Name Description Example
requestType a type of request search
action which action to take (same name as SOAP methods) regions
search search parameters “epc”:“2”, “typ”:“hotel”, …
header SOAP Header Information check example below

There are 4 types of requestType available:

  • search : for searching regions, offers and trips
  • info : to get object descriptions and flight information,
  • check : for availability request,
  • book : to create registrations, booking, cancellations

So fo example if you wish to search for hotels in a selected region, you create request like so:

{
  "requestType":"search",
  "action":"offers",
  "search":{
    "typ":"hotel",
    "vnd":"2018-01-10",
    "bsd":"2018-03-10",
    "tdc":"1-5",
    "rgcs":"100023",
    "epc":"2"
  },
  "header":{
    "lang":"[lang-code]",
    "usr":"[username]",
    "pass":"[password]",
    "agid":"[agency-id]"
  }
}

Response

If error occurs, this is an example of the output

{
  "errorNr":2001,
  "error":{"msg":"Invalid (or missing) action"}
  "rqid" : "request-id"
}

On success you will get a JSON string which is the same structure as you would get with SOAP requests. Please check SOAP Calls for details.

ors-soap-api/public/json_api.txt · Last modified: 2017/12/13 16:23 by admin