Format XML

W wyniku żądania za pomocą protokołu HTTP GET do Qtravel API zwracany jest XML zawierający:

  • Wyniki wyszukiwania w formacie XML w przypadku Qtravel Search API
  • Opis oferty w formacie XML w przypadku Qtravel Offer API

Przykładowa odpowiedź XML dla żądania w postaci:

//api.qtravel.pl/apis?qapikey=125371768e33eb299b923ed3ca28e71c&query=egipt

wygląda następująco

<response>
    <p>
      <p_offers>2630</p_query>
      <p_pages>263</p_pages>
      <p_page>2</p_page>
     </p>
    <f>
      <f_country>
        <item>Egipt</item>
        <item>Izrael</item>
      </f_country>
      <f_region>
        <item>Hurghada</item>
        <item>Sharm el Sheikh</item>
      </f_region>
      <f_city>
        <item>Hurghada</item>
        <item>Sharm el Sheikh</item>
      <f_month>
         <item>2013-03</item>
         <item>2013-04</item>
      </f_month>
      <f_price>
         <item>od 1000 do 2000 zł</item>
         <item>od 2000 do 3000 zł</item>
      </f_price>
      <f_period>
          <item>do 7 dni</item>
          <item>7 dni</item>
      </f_period>
      <f_mainte>
           <item>All Inclusive</item>
           <item>Śniadania i obiadokolacje</item>
      </f_mainte>
      <f_depart>
    	<item>Warszawa</item>
    	<item>Katowice</item>
      </f_depart>
      <f_person>
    	<item>2</item>
           <item>4</item>
      </f_person>
      <f_trans>
           <item>samolot</item>
      </f_trans>
      <f_categ>
           <item>30</item>
           <item>35</item>
           <item>40</item>
      </f_categ>
      <f_tourop>
           <item>Alfa Star</item>
           <item>Itaka</item>
      </f_tourop>
      <f_promo>
          <item>last minute</item>
      </f_promo>
        
    <offers>
        <o>
    	<o_details>
    	   <o_country><![CDATA[Egipt]]></o_country>
    	   <o_name><![CDATA[Emipre]]></o_name>
    	   <o_hname><![CDATA[Empire]]></o_hname> 
    	   <o_desc><![CDATA[Kategoria 3 Region Egipt,Hurghada Położenie Hotel zlokalizowany jest w centrum Hurghady (Dahar), ok. 6 km na północ od lotniska. Okolica pełna jest sklepów, barów, kawiarni, galerii, sklepów jubilerskich, kramów z]]>
    	  </o_desc>
    	  <o_code><![CDATA[03-1842-73C]]></o_code>
    	  <o_region><![CDATA[Hurghada]]></o_region> 
    	  <o_city><![CDATA[Hurghada]]></o_city>
    	  <o_tourop><![CDATA[Alfa Star]]></o_tourop>
    	  <o_trans>
    	    <o_tran><![CDATA[samolot]]></o_tran>
    	  </o_trans>
    	  <o_maintes>
    	      <o_mainte><![CDATA[AI]]></o_mainte>
    	      <o_mainte><![CDATA[HB]]></o_mainte>
    	  </o_maintes>
    	  <o_maintedescs>
    	      <o_maintedesc><![CDATA[śniadania i obiadokolacje]]></o_maintedesc>
    	      <o_maintedesc><![CDATA[All Inclusive]]></o_maintedesc>
    	  </o_maintedescs>
    	  <o_departs>
    	      <o_depart><![CDATA[Katowice]]></o_depart>
    	      <o_depart><![CDATA[Poznań]]></o_depart>
    	      <o_depart><![CDATA[Warszawa]]></o_depart>
    	  </o_departs>
    	  <o_bprice>1199.00</o_bprice>
    	  <o_bprice_currency>1199.00</o_bprice_currency>       <o_tourop_small_logo><![CDATA[//static.qtravel.pl/img/organizatorzy/alfa.png]]></o_tourop_small_logo>
    <o_tourop_big_logo><![CDATA[//static.qtravel.pl/img/organizatorzy/b/alfa.png]]></o_tourop_big_logo>
    	   </o_details>
    	   <o_photos>
    	   <o_photo_link>//f.qtravel.pl/alfa-star/empire-egipt-hurghada-1842/150x120-al-7-37-237-456237/empire-1.jpg</o_photo_link>
    	   </o_photos>
    	  <o_best>
    	     <o_b_datefr><![CDATA[22.03.2013]]></o_b_datefr>
    	     <o_b_person><![CDATA[2]]></o_b_person>
    	     <o_b_trans><![CDATA[samolot]]></o_b_trans>
    	     <o_b_price><![CDATA[1199.0]]></o_b_price>
    	     <o_b_dateto><![CDATA[2013-03-29]]></o_b_dateto>
    	     <o_b_mainte><![CDATA[śniadania i obiadokolacje]]></o_b_mainte>
    	     <o_b_period><![CDATA[7]]></o_b_period>
    <o_b_link><![CDATA[//www.qtravel.pl/alfa-star/empire-egipt-hurghada-1842?pc=86c2f9f10d2e98097f5b36026d4de044#tc=a870dc45ab06d5c0a891148b0cf9a9f4]]></o_b_link>
    	  <o_b_currency><![CDATA[PLN]]></o_b_currency>
    	 </o_best>
    
        </o>
        <o>
         …
        </o> 
    </offers>
</response>

Znaczniki XML

Lista wszystkich dostępnych i obsługiwanych znaczników XML znajduje się w tabeli poniżej:

Element Opis Atrybuty Podelementy
<response> Korzeń odpowiedzi XML <p>
<f>
<offers>
<p> Kontener dla informacji o zwróconych wynikach <p_offers>
<p_pages>
<p_page>
<p_offers> Liczba ofert pasujących do zapytania
<p_pages> Liczba stron
<p_page> Numer aktualnie zwróconej strony
<f> Kontener dla filtrów <f_country>
<f_region>
<f_city>
<f_month>
<f_price>
<f_period>
<f_mainte>
<f_depart>
<f_person>
<f_categ>
<f_trans>
<f_tourop>
<f_promo>
<f_country> Kontener dla filtru państwa. <item>
<f_country> Kontener dla filtru państwa. <item>
<f_region> Kontener dla filtru regiony. <item>
<f_city> Kontener dla filtru miejscowości. <item>
<f_price> Kontener dla filtru ceny. <item>
<f_period> Kontener dla filtru długość wyjazdu. <item>
<f_mainte> Kontener dla filtru wyżywienia. <item>
<f_depart> Kontener dla filtru miejsca wyjazdu. <item>
<f_person> Kontener dla filtru liczba osób. <item>
<f_categ> Kontener dla filtru kategoria hotelu. <item>
<f_trans> Kontener dla filtru typ transportu. <item>
<f_tourop> Kontener dla filtru organizator wycieczki. <item>
<f_promo> Kontener dla filtru promocja. <item>
<offers> Kontener na oferty zwrócone w wyniku wyszukiwania <o>
<o> Kontener na pojedynczą ofertę <o_details>
<o_photos>
<o_best>
<o_details> Kontener na szczegóły oferty <o_name>
<o_hname>
<o_country>
<o_region>
<o_city>
<o_hcat>
<o_code>
<o_desc>
<o_tourop>
<o_departs>
<o_trans>
<o_maintes>
<o_bprice>
<o_bprice_currency>
<o_tourop_small_logo>
<o_tourop_big_logo>
<o_link>
<o_link_reserv>
<o_name> Nazwa oferty
<o_hname> Nazwa obiektu którego dotyczy oferta
<o_country> Państwo
<o_region> Region
<o_city> Miejscowość
<o_hcat> Kategoria hotelu
<o_desc> Opis oferty lub fragmentu opisu pasujący do wyszukiwanej frazy
<o_tourop> Nazwa organizatora
<o_departs> Kontener na dostępne miejsca wyjazdu dla oferty <o_depart>
<o_depart> Dostępne miejsce wyjazdu dla oferty
<o_trans> Kontener na dostępne typy transportu dla oferty <o_tran>
<o_tran> Dostępny typ transportu dla oferty
<o_maintes> Kontener na dostępne typy wyżywienia dla oferty (skróty) <o_mainte>
<o_mainte> Dostępny typ wyżywienia (skrót)
<o_maintedescs> Kontener na dostępne typy wyżywienia (opisy) <o_maintedesc>
<o_bprice> Najlepsza cena dla oferty
<o_bprice_currency> Waluta w której prezentowana jest najlepsza cena dla oferty
<o_tourop_small_log> Małe logo organizatora
<o_tourop_big_logo> Duże logo organizatora
<o_link> Adres url do oferty na stronie Qtravel.pl
<o_link_reserv> Adres url do rezerwacji na stronie Qtravel.pl
<o_photos> Kontener na zdjęcia oferty
<o_photos_link> Adres url zdjęcia oferty
<o_best> Kontener na szczegóły terminu spełniającego kryteria wyszukiwania i filtrowania <o_b_link>
<o_b_promo>
<o_b_price>
<o_b_currency>
<o_b_period>
<o_b_datefr>
<o_b_dateto>
<o_b_person>
<o_b_trans>
<o_b_mainte>
<o_b_link> Adres url strony z rezerwacją dla terminu
<o_b_promo> Promocja
<o_b_price> Cena za osobę dostępnego terminu
<o_b_currency> Waluta
<o_b_period> Długość pobytu dla terminu
<o_b_datefr> Data wyjazdu dla terminu
<o_b_dateto> Data przyjazdu dla terminu
<o_b_person> Liczba osób dla terminu
<o_b_trans> Typ transportu dla terminu
<o_b_mainte> Wyżywienie dla terminu

Format XML dla Qtravel Offer API

Aby uzyskać informację na ten temat formatu odpowiedzi XML dla Qtravel Offer API skontaktuj się z Qtravel.pl