Yolcu360 Agency API ile Başlangıç

Yolcu360 Agency API, iş ortaklarımızın araç kiralama hizmetlerimizle kolayca entegre olmalarını sağlayan bir RESTful API'dir. Bu API ile şunları yapabilirsiniz:

• Konum arama
• Mevcut araçları sorgulama
• Rezervasyon oluşturma
• Ödeme işleme
• Siparişleri yönetme

API'yi kullanmak için önce bir API anahtarı ve gizli anahtarı edinmeniz gerekir. Bunun için pro.yolcu360.com adresindeki acente portalına giriş yapın ve API Anahtarları bölümünden yeni bir anahtar oluşturun.

API anahtarınızı kullanarak JWT jetonu almanız gerekir:

curl -X POST https://staging.api.pro.yolcu360.com/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "key": "API_ANAHTARINIZ",
    "secret": "API_GİZLİ_ANAHTARINIZ"
  }'

Başarılı yanıt:

{
  "accessToken": "eyJhbGciOiJIUzI1NiIs...",
  "refreshToken": "dGhpc2lzYXJlZnJlc2h0b2tlbg...",
  "accessTokenExpireAt": "2024-12-26T10:30:00Z",
  "refreshTokenExpireAt": "2024-12-27T10:00:00Z"
}

Aldığınız accessToken'ı tüm API çağrıları için Authorization başlığında kullanın:

curl -X GET https://staging.api.pro.yolcu360.com/api/v1/locations?query=istanbul \
  -H "Authorization: Bearer ERIŞIM_JETONUNUZ"

API'miz iki farklı ortamda hizmet verir:

⚠️ Önemli: Test ortamında yapılan rezervasyonlar gerçek değildir. Test ortamında ödemeler yalnızca "Yolcutest" tedarikçisi için desteklenmektedir. Bu kurala takılan ödemeler 6008 hata koduyla yanıtlanır.

API'miz saniyede maksimum 10 istek kabul eder. Bu sınırı aşarsanız 429 Too Many Requests hatası alırsınız.

API standart HTTP durum kodlarını kullanır:

• 200 OK - İstek başarılı
• 201 Created - Kaynak oluşturuldu
• 400 Bad Request - Geçersiz istek
• 401 Unauthorized - Kimlik doğrulama hatası
• 403 Forbidden - Yetkilendirme hatası
• 404 Not Found - Kaynak bulunamadı
• 429 Too Many Requests - Hız sınırı aşıldı
• 500 Internal Server Error - Sunucu hatası

Hata yanıtları şu formattadır:

{
  "code": 1001,
  "description": "Geçersiz istek parametreleri",
  "details": {
    "field": "checkInDateTime",
    "message": "Gelecek bir tarih olmalı"
  }
}

Teknik destek için:

• E-posta: api-support@yolcu360.com
• Dokümantasyon: docs.yolcu360.com