API Dökümantasyonu

1. Kimlik Doğrulama

Tüm kapalı isteklere, aldığınız API erişim anahtarınızı (API Key) dahil etmelisiniz. Önerilen yöntem, anahtarın x-api-key HTTP başlığı (header) olarak iletilmesidir. Ayrıca test yapmak için URL parametresi olarak ?apiKey= şeklinde de kullanılabilir.

Örnek Kimlik Doğrulama İşlemi

curl -X GET https://reyonbul.com/api/search?q=Sut \
  -H "x-api-key: SIZIN_API_ANAHTARINIZ"

2. Ürün Arama Modülü (Search)

Sistemde bulunan tüm marketlerde aynı anda arama yapar. En ucuz fiyatlısına göre ürünleri tek bir liste halinde döndürür.

Parametreler (JSON Body)

• query (Metin): Aramak istediğiniz kelime (Zorunlu).
• excludeMarkets (Dizi): Aramaya dahil edilmeyecek (dışlanacak) market isimleri.
• cache (Mantıksal): Arama performansını artırmak için sonucun önbelleklenmesi. (Varsayılan: true)

Örnek İstek

curl -X POST https://reyonbul.com/api/search \
  -H "Content-Type: application/json" \
  -H "x-api-key: SIZIN_API_ANAHTARINIZ" \
  -d '{
    "query": "Süt",
    "excludeMarkets": ["A101"],
    "cache": true
  }'

Örnek Yanıt

{
  "response_time": "125.40ms",
  "data": [
    {
      "id": "645bd...",
      "name": "Pınar Süt 1L",
      "image": "https://...",
      "markets": [
        {
          "details": {
            "name": "Migros",
            "icon": "..."
          },
          "price": 32.50,
          "discounted_price": 29.90,
          "is_discounted": true,
          "url": "https://..."
        }
      ]
    }
  ]
}

3. Desteklenen Marketler

Şu anda arama sistemimiz tarafından taranan aktif marketlerin listesini döndürür. Bu rota kimlik doğrulaması gerektirmez, public olarak erişilebilir. Dönen isimleri excludeMarkets dizisi içine koyabilirsiniz.

Örnek İstek

curl -X GET https://reyonbul.com/api/markets