Məzmuna keç
ByCar
API v1 · REST · JSON · Webhook-lar

ByCar-ı məhsulunuza qoşun

Otellər, tur operatorları və agentlər: transfer və turları birbaşa öz sisteminizdən sifariş edin, aktual qiymətləri və status yeniliklərini webhook ilə alın. Açarlar partnyor kabinetində bir neçə dəqiqəyə.

Bizimlə işləməyin üç yolu

Böyük sistemlər API istifadə edir. API yoxdur? Hər şeyi kabinetdə əl ilə edin — ortaq baza, ona görə ikiqat sifariş olmur.

REST

Partnyor API

Qiymətlər, sifarişlər, status, ləğv, yönləndirmələr. İmzalı webhook-lar.

Arayış →
Kodsuz

Partnyor kabineti

Əl ilə sifarişlər, komissiya, hesabatlar və açarların idarəsi — bir ekranda.

partner.bycar.ge →
İcarə

Avtomobil sahibləri

Başqa yerdə sifariş olunub? Məşğul günləri təqvimdə qeyd edin — rent.bycar.ge onları satmayacaq.

Sahib kabineti →

4 addımda başlayın

İlk sifariş təxminən 15 dəqiqəyə.

  1. 1

    Tərəfdaş olun

    bycar.ge/join ünvanında və ya aşağıdakı forma ilə müraciət edin.

  2. 2

    Açar yaradın

    partner.bycar.ge → Şəbəkə → API. Test və real rejim.

  3. 3

    Yoxlayın

    GET /v1/ping — açar etibarlıdırmı?

  4. 4

    Rezerv et

    POST /v1/bookings — client_ref təkrar sorğuları təhlükəsiz edir.

Kod nümunələri

Əməliyyat və dil seçin, sonra serverinizə yapışdırın. Açarı heç vaxt brauzer və ya tətbiq koduna qoymayın.

curl -X POST "$BASE/v1/bookings" \
  -H "X-API-Key: $BYCAR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "transfer",
  "client_ref": "4f6b2c1e-1111-4222-8333-444455556666",
  "pickup": {
    "name": "Tbilisi Airport",
    "lat": 41.6692,
    "lon": 44.9547
  },
  "dropoff": {
    "name": "Hotel Rooms, Kazbegi",
    "lat": 42.659,
    "lon": 44.643
  },
  "travel_date": "2026-12-01",
  "travel_time": "10:30",
  "flight_no": "W6 1234",
  "pax": 2,
  "cls": "eco",
  "vehicle": "sedan",
  "guest": {
    "name": "Jane Doe",
    "phone": "+995555111222",
    "email": "jane@example.com"
  }
}'

Təhlükəsizlik

Açarlar yalnız SHA-256 heşi kimi saxlanılır. IP icazə siyahıları, sorğu limitləri, müddət və 14 günlük jurnal. HMAC imzalı webhook-lar.

API yoxdur?

Sifarişləri partnyor kabinetində əl ilə daxil edin və ya avtomobiliniz varsa, məşğul günləri qeyd edin — biz bunu görürük və ikiqat sifariş olmayacaq.

Kabineti aç →

API girişi istə

24 saat ərzində cavab verib API-ni sizin üçün aktivləşdiririk.

Kömək