Geliştiriciler

Fiyat verisini kendi sisteminize taşıyın.

Panelde gördüğünüz her şeye REST API üzerinden erişebilirsiniz. Kimlik doğrulama kişisel erişim tokenıyla yapılır; her istek token sahibinin çalışma alanına sınırlıdır.

Ücretsiz token alın API kotalarını görün

Kimlik doğrulama

Token'ı Ayarlar → API anahtarları ekranından oluşturun ve Authorization başlığında gönderin.

curl -H "Authorization: Bearer <token>" \

     https://pricerio.webze.net/api/v1/usage

Örnek: global arama

POST /api/v1/searches

{

  "query": "Sony WH-1000XM5",

  "type": "auto",

  "country": "DE",

  "currency": "TRY"

}

Yanıt; eşleşen ürünü, aday ürünleri ve toplam maliyete göre sıralanmış teklifleri döner. Her çağrı paketinizin aylık arama kotasından düşer.

Uç noktalar

Metot	Yol
GET	/api/v1/usage
POST	/api/v1/searches
GET	/api/v1/products
GET	/api/v1/products/{id}
GET	/api/v1/products/{id}/offers
GET	/api/v1/products/{id}/price-history
GET	/api/v1/watchlists
POST	/api/v1/watchlists
POST	/api/v1/watchlists/{id}/items
GET	/api/v1/alerts
POST	/api/v1/alerts
DELETE	/api/v1/alerts/{id}

Sınırlar ve hata davranışı

Sürprizsiz entegrasyon için bilmeniz gerekenler.

Hız limiti

Kimlik doğrulanmış istekler için dakikada 120, arama uçları için dakikada 30 istek. Limit aşımında 429 döner.

Kota aşımı

Paket kotası dolduğunda 429 ve error: quota_exceeded gövdesi döner; kullanılan ve limit değerleri yanıtta yer alır.

İzolasyon

Token yalnızca sahibinin çalışma alanını görür. Başka bir çalışma alanının kaydını istemek 404 döner.