Christian Tour

Documentatie implementare API ChristianTour

Acest document descrie solutia de API pentru preluare ofertelor ChristianTour.

Acest document este proprietatea ChristianTour. Toate drepturile rezervate

Documentatie Implementare XML API

ChristianTour

Destinatari Destinatar
Client

Approval

Autor Marius Constantin

Versiuni Data 01.10.2013 Versiune 1.0 Descriere

Creare document.

Fisier Nume Documentatie XML.pdf Descriere

Documentatie Implementare

Status
Creat

Pagina 2 din 9

Documentatie Implementare XML API

ChristianTour

Cuprins
1. Introducere ................................................................................................................................ 4
1.1. Obiectiv ................................................................................................................................................... 4 1.2. Metode implementate ............................................................................................................................ 4

2. Solutia Tehnica ......................................................................................................................... 5

2.1. Software Prerequisites........................................................................................................................... 5

3. Descrierea Metodelor................................................................................................................ 6
3.1. get_offers ................................................................................................................................................ 6 3.2. get_geography ........................................................................................................................................ 6 3.3. get_view .................................................................................................................................................. 7 3.4. request_rooms........................................................................................................................................ 8

Pagina 3 din 9

Documentatie Implementare XML API

ChristianTour

1. Introducere
1.1. Obiectiv
Acest document contine documentatia tehnica pentru implementarea API-ului Christian Tour pentru preluarea ofertelor.

1.2. Metode implementate

get_offers get_geography get_view request_rooms

Pagina 4 din 9

Documentatie Implementare XML API

ChristianTour

2. Solutia Tehnica
2.1. Software Prerequisites
API-ul Christian Tour poate fi accesat de toti partenerii nostri, care in prealabil vor primi un utilizator si o parola, in urma unei cerei pe email. URL-ul pentru accesare este http://www.christiantour.ro/reseller_api/index iar parametrii aferenti fiecarei metode vor fi trimisi prin POST. Raspunsul API-ului este de tip JSON

Pagina 5 din 9

Documentatie Implementare XML API

ChristianTour

3. Descrierea Metodelor
3.1. get_offers
Se apeleaza de forma http://www.christiantour.ro/reseller_api/index cu parametrii: a. action = get_offers b. username = username c. password = password Username si password sunt primiti in prealabil pe email. Metoda va intoarce toate ofertele prezente in acel moment pe site-ul nostru. Recomandam folosirea ei de maxim 2 ori pe zi, pentru a evita load-ul mare pe server. Ex raspuns (1 item): {"id":"8","type":"circuit","departure_id":"4","departure_destination_id":"0","departure_destination_t itle":"","departure_destination_url":"","search_id":"15866","intern":"0","search_url":"src0h513874c3 ecc81","result_id":"47591","package_id":"0","circuit_id":"156","offer_title":"Istanbul avion 2013","offer_url":"istanbul-avion-2013","offer_description":"Copiii beneficiaza de reducere pt. cazare in camera cu doi adulti. Pentru explicatii la obiectivele turistice (in ziua 2), grupul va achita cate 5 \/ pers. In Turcia, pentru servicii de ghizi locali (obligatoriu impus prin lege). Programul","hotel_id":"0","attribute_id":"0","hotel_type":null,"hotel_name":null,"hotel_url":null,"h otel_description":"","hotel_stars":"0","country_id":"23","country_title":"Turcia","country_url":"turcia ","destination_id":"173","destination_title":"Istanbul, Turcia","destination_url":"istanbulturcia","destination_visible":"0","transport_id":"2","transport_name":"Avion","transport_url":"avion" ,"image_src":"image_1353060120_app0a50a60f182c16.jpg","image_alt":"Moscheea Albastra, Istanbul, Turcia","room_type":"Hotel 3* Turcia","meal_plan":"Mic dejun ","meal_plan_url":null,"discount_info":"","price":"450.00","discount":"0.00","hot_deal":"0","tax":"19 0.00","status":"unavailable","created":"2013-10-01 13:28:16","modified":"2013-10-01 13:28:16","min_price":"450.00"}

3.2. get_geography
Se apeleaza de forma http://www.christiantour.ro/reseller_api/index cu parametrii: d. action = get_geography e. username = username f. password = password\

Metoda intoarce geografia din site pentru oferte.

Ex raspuns: {"id":"14","title":"Albena, Bulgaria","url":"albena-bulgaria","info_text":"<p>\n Albena este locatia ideala pentru cupluri si sau familii in cautarea unei vacante relaxante si insorite cu mancare gustoasa si experiente nemaipomenite.<\/p>\n","description":"<h2>\n <strong>Geografie pe scurt<\/strong><\/h2>\n<p>\n &nbsp;<\/p>\n<p>\n Statiunea Albena este situata in nordul coastei Marii Negre, nu foarte departe de granita cu Romania, la aproximativ 40 km distanta de aeroportul din Varna si 12 km de Nisipurile de Aur<\/p>\n<p>\n &nbsp;<\/p>\n<p>\n Climatul temperat continental, plaja intinsa cu nisip, apa limpede vor garanta conditii minunate pentru o vacanta la malul marii din mai pana in octombrie.<\/p>\n<p>\n &nbsp;<\/p>\n<p>\n Inconjurata de paduri luxuriante, principala atractie a Albenei este, fara indoiala, plaja cu nisip de 7 km lungime.<\/p>\n<h2>\n <strong>Istorie<\/strong><\/h2>\n<p>\n &nbsp;<\/p>\n<p>\n Albena a fost descoperita ca destinatie turistica in anii 1960, majoritatea cladirilor, strazilor si caselor din Albena au contribuit la dezvoltarea turismului din acea perioada.<\/p>\n<p>\n &nbsp;<\/p>\n<p>\n Unii ar crede ca aceasta zona creata special pentru turism nu mai are niciun farmec, dar Albena debordeaza in traditii culturale, mancare extraordinara si diverse modalitati de
Pagina 6 din 9

Documentatie Implementare XML API

ChristianTour

divertisment.<\/p>\n<h2>\n <strong>Shopping<\/strong><\/h2>\n<p>\n &nbsp;<\/p>\n<p>\n Albena nu are niciun centru comercial cu magazine in intreaga statiune.<\/p>\n<p>\n &nbsp;<\/p>\n<p>\n Mini &ndash;marketurile ofera produsele esentiale dar exista si magazine de suveniruri de unde turistii pot cumpara cadouri pentru cei dragi de acasa. Multe dintre acestea sunt magazine artizanale cu sculpturi din lemn, cutii, produse din piele sau lenjerii de pat brodate manual.<\/p>\n<h2>\n <strong>Distreaza-te!<\/strong><\/h2>\n<p>\n &nbsp;<\/p>\n<p>\n Desi viata de noapte din Albena poate fi destul de animata, niciodata nu poate fi considerata una zgomotoasa.<\/p>\n<p>\n &nbsp;<\/p>\n<p>\n Atmosfera este una relaxata pe timp de seara, data de numarul mare de familii care isi petrec aici vacanta.<\/p>\n<p>\n &nbsp;<\/p>\n<p>\n &nbsp;Cazinoul Variety ofera concerte si spectacole precum si jocuri de noroc.<\/p>\n<h2>\n <strong>Mancarea<\/strong><\/h2>\n<p>\n &nbsp;<\/p>\n<p>\n Albena are un numar mare de restaurante, multe dintre acestea sunt anexate hotelurilor, precum si cafenelele sau tavernele.<\/p>\n<p>\n &nbsp;<\/p>\n<p>\n Felurile de mancare traditionale bulgaresti sunt contin o multime de fructe si legume proaspete.<\/p>\n<p>\n &nbsp;<\/p>\n<p>\n Ardeii umpluti si frunzele de vita sunt renumite. Incercati specialitatea&rdquo; Banista&rdquo;, o placinta de branza care se topeste in gura.<\/p>\n<p>\n &nbsp;<\/p>\n<p>\n Bulgaria este un mare producator de vin european. In nord sunt faimoase vinurile albe iar in sud cele rosii.<\/p>\n","informations":"<h2>\n <strong>Clima<\/strong><\/h2>\n<div>\n &nbsp;<\/div>\n<div>\n &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Apr. Mai Iun. Iul. Aug. Sept. Oct.<\/div>\n<div>\n Temperatura<\/div>\n<div>\n medie (&ordm;C)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 16&nbsp;&nbsp; 22&nbsp;&nbsp; 26&nbsp;&nbsp; 30&nbsp;&nbsp; 29&nbsp;&nbsp;&nbsp; 26&nbsp;&nbsp;&nbsp;&nbsp; 21<\/div>\n<div>\n &nbsp;<\/div>\n<div>\n Durata de stralucire<\/div>\n<div>\n a soarelui (ore) 6&nbsp;&nbsp;&nbsp; 8&nbsp;&nbsp; &nbsp;&nbsp;9&nbsp;&nbsp;&nbsp; 11&nbsp;&nbsp; 10&nbsp;&nbsp;&nbsp; &nbsp;8&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;6<\/div>\n<h2>\n <strong>Excursii optionale<\/strong><\/h2>\n<p>\n &nbsp;<\/p>\n<p>\n - Kaliakra<\/p>\n<p>\n - Parcul National<\/p>\n<p>\n - Turul Safari<\/p>\n<h2>\n <strong>Plaje si sporturi acvatice<\/strong><\/h2>\n<p>\n &nbsp;<\/p>\n<p>\n In locul catorva plaje mici combinate cu viata de oras pe care le veti gasi in alte zone turistice, plaja din Albena este o singura intindere lunga de 7 km de pe malul Marii Negre.<\/p>\n<p>\n &nbsp;<\/p>\n<p>\n Apa este una dintre cele mai linistite si ofera conditiile si temperaturile perfecte pentru inot sau practicarea multor sporturi acvatice.<\/p>\n<p>\n &nbsp;<\/p>\n<p>\n Peisajul este unul perfect, contrastul dintre nisipurile albe cu apa il fac unul dintre cele mai bune locuri pentru a urmari apusul soarelui.<\/p>\n<p>\n &nbsp;<\/p>\n<p>\n O vacanta la malul marii nu ar fi perfecta fara practicarea unui sport acvatic. Statiunea Albena ofera plimbare cu banana, ski jet, parasailing, surf etc. dar si posibilitatea de a primi indrumare pentru unul din aceste sporturi.<\/p>\n","keywords":"","latitude":"43.367327","longitude":"28.080399\u200e","zoom":"10","continent_id":"2"," country_id":"6","region_id":"6","county_id":"0","city_id":"0","is_individual":"0","order":"0","visible":"1","created":"201205-17 14:52:44","modified":"2012-09-20 07:32:47","continent":"Europa","country":"Bulgaria","region":"Albena","city":null}

3.3. get_view
Se apeleaza de forma http://www.christiantour.ro/reseller_api/index cu parametrii: g. action = get_view h. username = username i. j. password = password url = url-ul ofertei. Acesta vine pe get_offers la fiecare oferta, parametrul fiind: offers_url

k. search_url = url-ul cautarii. Acesta vine pe get_offers la fiecare oferta, parametrul fiind: search_url l. result_id = rezultatul cautarii. Acesta vine pe get_offers la fiecare oferta, parametrul fiind result_id

m. type = tipul ofertei. Acesta vine pe get_offers la fiecare oferta si poate avea valorile : hotel / package / circuit Metoda intoarce toate detaliile unei oferte.
Pagina 7 din 9

Documentatie Implementare XML API

ChristianTour

3.4. request_rooms
Metoda realizeaza validarea pretului si a unei camere pentru o data de rezervare.

Se apeleaza de forma http://www.christiantour.ro/reseller_api/index cu parametrii: a. action = request_rooms b. username c. password Pentru fiecare request (in functie de tipul ofertei) avem parametri diferiti, dupa cum urmeaza: 1. hotel a. type = hotel b. url = url-ul ofertei c. search_url = url-ul cautarii d. result_id = rezultatul cautarii e. checkin = data de checkin f. duration = durata ofertei

g. selected = room si meal plan de forma : result_id-meal_plan_index 123456-0 ( 0 fiind meal_plan_index pentru camera aleasa ) Notice: selected este optional doar daca se alege validarea direct la o camera aleasa, ce vine de pe get_view. 2. Package a. type = package b. url = url-ul ofertei c. departure_point = id-ul punctului de plecare. Acestea sunt disponibile din get_view d. departure = data de plecare. Aceasta vine din get_view e. duration = durata sejurului f. transport_type = tipul de transport al sejurului

g. selected = room si meal plan de form : rezult_id-meal_plan_index 123456-0 ( 0 fiind meal_plan_index pentru camera aleasa ) h. Notice: selected este optional doar daca se alege validarea direct la o camera aleasa, ce vine de pe get_view.

3. Circuit a. type = circuit b. url = url-ul ofertei

Pagina 8 din 9

Documentatie Implementare XML API

ChristianTour

c. departure_point = id-ul punctului de plecare. Acestea sunt disponibile din get_view d. departure = data de inceput a circuitului. Aceasta vine din get_view e. duration = durata sejurului f. transport_type = tipul de transport al circuitului

g. hotel = hotel-ul circuitului. Acestea sunt disponibile din get_view h. selected = room si meal plan de form : rezult_id-meal_plan_index 123456-0 ( 0 fiind meal_plan_index pentru camera aleasa ) Notice: selected este optional doar daca se alege validarea direct la o camera aleasa, ce vine de pe get_view.

Pagina 9 din 9