Helper Servisi API Dökümantasyonu (v3)

Yardımcı servisler (TC Kimlik doğrulama ve Google Harita) bu modül altında yer alır.

Base URL: /v3/helpers

---

1. Verify Identity (TC Kimlik Doğrulama)

NVI (Nüfus ve Vatandaşlık İşleri) üzerinden TC Kimlik doğrulaması yapar.

• URL: POST /verify-identity
• Auth: Yok
• Request Body:

  {
    "identity": "12345678901 (zorunlu — TC Kimlik No)",
    "birth_year": "1990 (zorunlu)",
    "firstname": "Ahmet (zorunlu)",
    "lastname": "Yılmaz (zorunlu)"
  }

---

---

Google Servisleri

Google Maps Platform API'leri ile entegre yardımcı uçlar.

Base URL: /v3/helpers/google

---

2. AutoComplete (Adres Otomatik Tamamlama)

Kullanıcı yazarken Google Places AutoComplete sonuçlarını döner.

• URL: POST /autocomplete
• Auth: ClientSecret
• Request Body:

  {
    "search": "İstanbul Kadıköy ... (zorunlu)"
  }

---

3. Distance (Mesafe Hesaplama)

İki koordinat arası mesafe ve süre hesaplar (Google Distance Matrix).

• URL: POST /distance
• Auth: ClientSecret
• Request Body:

  {
    "origin": {
      "latitude": 41.0082,
      "longitude": 28.9784
    },
    "destination": {
      "latitude": 39.9334,
      "longitude": 32.8597
    }
  }

---

4. Geocode (Adres → Koordinat)

Metin adresinden koordinat bilgisi döner.

• URL: POST /geocode
• Auth: ClientSecret
• Request Body:

  {
    "address": "Kadıköy, İstanbul (zorunlu)"
  }

---

5. Place Details (Yer Detayı)

Google Place ID ile detaylı yer bilgisi döner.

• URL: GET /places/:place_id
• Auth: ClientSecret