API Belgeleri
Hal fiyatlarını kendi uygulamanızda kullanın. API ücretsizdir, anahtar gerektirmez ve kayıt istemez.
Uç noktalar
| Yol | Ne döner | Parametre |
|---|---|---|
| GET /api/v1/products | Yayımdaki her ürün ve en son göstergesi | — |
| GET /api/v1/prices/latest | Ürün başına en güncel gösterge; her satır kendi gününü taşır | — |
| GET /api/v1/search | Ürün ve hal araması, Türkçe katlamayla | q (zorunlu) — Aranan metin |
| GET /api/v1/index/{slug} | Yayımlanmış bir endeks serisi; yayımlanmamışsa 409 | slug (zorunlu) — Endeks kısa adı |
| GET /api/v1/health | Kurulum durumu; uydurma veri modunda 503 | — |
Makine tarafından okunabilir tanım: /api/v1/openapi.json. Bu belge elle yazılmaz; yanıt şemalarından üretilir ve sözleşme testi gerçek yanıtları aynı şemalardan geçirir, böylece belge ile davranış birbirinden ayrı düşemez.
Örnek
curl "https://haldefiyat.botanikdemo.com/api/v1/prices/latest" curl "https://haldefiyat.botanikdemo.com/api/v1/search?q=domates" curl "https://haldefiyat.botanikdemo.com/api/v1/prices/history/domates?range=30d"
Kurallar
- Kaynak bildirimi zorunludur. Her yanıt bir
attributionalanı, her satır kendi kaynağını ve veri gününü taşır. Bu bir süs değil: İBB ve İzmir açık veri lisansları yeniden yayımı buna bağlar. Veriyi gösterirken bu bildirimi de gösterin. - İstek sınırı dakikada 60. Aşıldığında 429 döner. Sınır IP başınadır ve dağıtım sırasında sıfırlanır; amacı tek bir dikkatsiz betiğin siteyi yavaşlatmasını önlemektir.
- Her satır kendi gününü taşır. Haller farklı günlerde yayımlar; "en güncel" ürün başına hesaplanır. Tek bir "bugün" varsayarsanız eski bir sayıyı taze gibi gösterirsiniz.
- Şüpheli ve devralınan kayıtlar hesaplara girmez. Kalite kuralları /kaynaklar sayfasında yazılıdır.
Kullanım koşulları ve adil kullanım: /api-policy.