Resurse pentru dezvoltatori

API Bileteavia de căutare a zborurilor pentru asistenți AI

O interfață doar pentru citire care caută opțiuni actuale de zbor și trimite călătorul înapoi pe Bileteavia cu ruta, datele și numărul de pasageri deja pregătite.

Căutare doar pentru citire API v1 EUR

Observații actuale de căutare

Rutele, orele, codurile companiilor și starea disponibilității sunt normalizate din răspunsul furnizorului pentru datele cerute.

Prețuri pentru client

Fiecare sumă trece prin regulile actuale de ajustare a biletelor din administrarea Bileteavia. API-ul nu expune tariful de bază al furnizorului sau valoarea ajustării.

Limită tranzacțională sigură

Căutarea nu creează sesiune, lead, rezervare, plată, e-mail sau notificare Discord. Pentru rezervare este necesar fluxul separat al website-ului.

Contract HTTP

Endpoint și parametri de căutare

Trimite o cerere GET cu codurile IATA și o dată de plecare eligibilă. Parametrii necunoscuți sunt respinși pentru ca integrările să nu trimită în tăcere date de călătorie neacceptate.

GET https://bileteavia.md/api/v1/flights/search?origin=RMO&destination=CDG&departureDate=YYYY-MM-DD&passengers=1&currency=EUR
Parametru Obligatoriu Semnificație
origin Da Codul IATA din trei litere al aeroportului de plecare.
destination Da Codul IATA din trei litere al destinației, diferit de plecare.
departureDate Da Data plecării în format AAAA-LL-ZZ, de azi până la 370 de zile.
returnDate Nu Data opțională de întoarcere, după plecare și în limita a 370 de zile.
passengers Nu Numărul de pasageri adulți de la 1 la 9; implicit 1.
cabin Nu economy sau business; implicit economy.
currency Nu Doar EUR în versiunea 1, pentru ca ajustările fixe din admin să rămână corecte valutar.
baggage Nu Doar any; includerea bagajului este raportată ca neconfirmată.

Ce înseamnă un răspuns reușit

Răspunsul JSON ajută asistenții să descrie corect opțiunile fără a transforma o observație de căutare într-o promisiune de rezervare.

  • Suma este în EUR, include ajustarea aplicabilă din admin și este marcată ca indicativă.
  • Disponibilitatea indică momentul observării opțiunii și necesită întotdeauna reverificare.
  • Segmentele de plecare și întoarcere opțională includ aeroporturi, ore, durată, escale și coduri de companie atunci când furnizorul le oferă.
  • continue_search_url deschide pe Bileteavia o nouă căutare pentru client cu datele normalizate ale cererii.
Prețul și disponibilitatea nu sunt garantate Bileteavia reverifică opțiunea selectată înainte de rezervare. Un asistent nu trebuie să afirme că locul este rezervat sau că tariful afișat este final.

Conectarea endpointului la Gemini

Gemini nu execută automat un API descoperit în Google Search. Aplicația care integrează controlează executarea instrumentului.

  1. 1Încarcă declarația publicată pentru funcția Gemini și include-o în lista de instrumente trimisă către Gemini API.
  2. 2Când Gemini returnează search_bileteavia_flights, validează argumentele și apelează endpointul GET Bileteavia cu acei parametri de interogare.
  3. 3Returnează răspunsul JSON către Gemini și afișează continue_search_url călătorului ca acțiune următoare.

Declarația publică este metadată de integrare, nu înregistrare automată la Google și nu garantează includerea în AI Overviews sau AI Mode.

Continuă pe Bileteavia

API-ul susține descoperirea și compararea. Website-ul rămâne locul destinat clientului pentru reverificarea opțiunii și continuarea spre rezervare.

Caută zboruri

Întrebări despre API-ul de căutare

Google AI va apela automat acest API?

Nu. Google Search poate indexa și cita această pagină de documentație, dar o aplicație Gemini trebuie să înregistreze explicit funcția și să execute apelul API.

Prețurile returnate includ ajustările din administrarea Bileteavia?

Da. Suma publică include deja ajustarea aplicabilă prețului biletului configurată în admin, dar rămâne indicativă și necesită reverificare.

O căutare API creează un lead sau o rezervare?

Nu. Căutarea este doar pentru citire și nu creează sesiune, lead CRM, notificare Discord, rezervare, plată sau e-mail.