OpenAPI 3.0

API Dokümantasyonu

Swagger UI ile canlı test. Tüm endpoint'ler, şemalar ve örnek istekler.

Swagger yerel sunucuda çalışmıyor.

Önce API'yi başlatın:

bash scripts/run-barlasmaps-api.sh

Prod ortamı: api.barlasmaps.com/docs

Entegrasyon rehberi

Hızlı başlangıç

# 1. API anahtarınızı alın (iletisim sayfası)
# 2. Rota isteği gönderin
curl -X POST http://127.0.0.1:8080/v1/route \
  -H "x-api-key: barlasmaps-dev" \
  -H "Content-Type: application/json" \
  -d '{"origin":{"lat":41.01,"lng":28.97},
       "destination":{"lat":39.93,"lng":32.86}}'

# 3. Geocode
curl -G http://127.0.0.1:8080/v1/geocode \
  -H "x-api-key: barlasmaps-dev" \
  --data-urlencode "q=Kadıköy İstanbul"