Integracije

Agency API omogućava rezervacionom i back-office softveru da povlači upite sa Tipujema, šalje ponude i javlja rezervacije — bez prekucavanja.

Za koga je

Turističke agencije i proizvođači softvera (CRS, DMC alati, internа knjiženja). Token važi samo za tu agenciju i samo za upite sa njenog tržišta.

Autentifikacija

Svaki zahtev šalje header Authorization: Bearer {token}. Token kreirate u agencijskom nalogu, pod API. Token se prikazuje samo jednom.

Poslovna pravila koja API poštuje

Agencija vidi samo upite sa svog tržišta (npr. srpska agencija ne vidi hrvatske putnike).
Kontakt putnika je zaključan dok putnik ne odabere vašu ponudu. Polje contact je tada null, contact_locked: true.
Plaćanje aranžmana nije u API-ju. Kad prijavite buking, platforma računa 0,9% uspešne provizije.

Base URL zavisi od okruženja. Lokalno je ispod.

https://tipujemputujem.com/api/v1

Endpointi

Method	Path	Opis
GET	`/me`	Profil agencije
GET	`/requests`	Upiti dodeljeni agenciji
GET	`/requests/{id}`	Detalj upita (kontakt zaključan do odabira)
POST	`/requests/{id}/offers`	Pošalji strukturiranu ponudu
POST	`/requests/{id}/decline`	Odbij upit
GET	`/offers`	Poslate ponude
GET	`/bookings`	Odabrane ponude / leadovi
POST	`/bookings/{id}/booked`	Prijavi realizovanu rezervaciju
POST	`/bookings/{id}/not-booked`	Prijavi da nije bukirano

Primer: lista upita

curl https://tipujemputujem.com/api/v1/requests \
  -H "Authorization: Bearer tip_****************" \
  -H "Accept: application/json"

POST /requests/{id}/offers

{
  "title": "Hanioti family package",
  "hotel_name": "Blue Bay Hotel",
  "hotel_stars": 4,
  "start_date": "2026-07-10",
  "end_date": "2026-07-20",
  "nights": 10,
  "transport_type": "bus",
  "meal_type": "all_inclusive",
  "total_price": 1487,
  "included": ["Transfer", "Osiguranje"],
  "excluded": ["Boravišna taksa"]
}

POST /bookings/{id}/booked

{
  "final_booking_amount": "1487.00",
  "currency": "EUR",
  "agency_booking_reference": "DT-28412",
  "booked_at": "2026-06-01"
}

Generiši token u agencijskom nalogu