REST API

API key yonetimi ve dokumantasyon

Yeni API Key Olustur

Key Adi

Rate Limit (istek/saat)

Mevcut API Keyler

API Dokumantasyonu

REST API endpoint bilgileri

GET

/api/v1/companies

Firma listesini getirir. Filtreleme, sayfalama ve siralama destekler.

Query Parametreleri:

page - Sayfa no (varsayilan: 1)
limit - Sayfa basina kayit (1-100, varsayilan: 20)
source - perpa | google_maps | yandex_maps
category - Kategori filtresi
search - Ad/adres/telefon ile arama
sortBy - name | category | rating | createdAt | reviewCount
sortOrder - asc | desc
minRating - Minimum puan (0-5)
favoritesOnly - true (sadece favoriler)

Kimlik Dogrulama

Tum API isteklerinde asagidaki header'lardan birini gonderin:

Authorization: Bearer fp_your_api_key_here

veya

X-Api-Key: fp_your_api_key_here

Ornek Istek (curl)

curl -H "Authorization: Bearer fp_xxx" "https://your-domain/api/v1/companies?source=perpa&limit=10"

Ornek Yanit

{
  "data": [
    {
      "id": "uuid",
      "name": "Firma Adi",
      "source": "perpa",
      "category": "Elektronik",
      "phone": "+90...",
      "rating": 4.5,
      ...
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 150,
    "totalPages": 8
  }
}

Rate Limiting

Her API key icin saat basina istek limiti vardir (varsayilan: 100/saat). Limit asildiginda 401 hatasi doner. Limit her saat basinda sifirlanir.

Hata Yaniti

{
  "error": "Rate limit asildi. Limit: 100 istek/saat",
  "status": 401
}