Cevap Bloğu
ONEPiR API nedir? ONEPiR API, e-ticaret geliştiricilerinin kur verilerini JSON formatında almasını, fiyat güncelleme tetiklemesini ve ilgili işlemleri programatik olarak yapmasını sağlayan REST tabanlı bir arayüzdür. API anahtarı ile authentication yapılır; endpoint’ler HTTPS üzerinden sunulur.
Apı Kimlik Doğrulama Ve Örnek Kodlar
Authentication: API anahtarı ONEPiR.com panelinden alınır. İsteklerde Authorization header’ında Bearer token veya x-api-key formatında gönderilir. Anahtar asla istemci tarafında (JavaScript, mobil uygulama) açıkta bırakılmamalıdır.
Node.js örneği: fetch veya axios kullanılır. Headers: { Authorization: Bearer API_KEY } veya { x-api-key: API_KEY } eklenir. const data = await response.json(); ile yanıt parse edilir.
Python örneği: requests kütüphanesi kullanılır. headers = { Authorization: Bearer + api_key } veya { x-api-key: api_key }. r = requests.get(url, headers=headers); data = r.json().
cURL örneği: curl -H “Authorization: Bearer API_KEY” https://api.ONEPiR.com/currency. Gerçek base URL dokümantasyondan alınmalıdır.
Json Yanıt Analizi
Kur endpoint’i yanıtı: kurlar nesnesi altında hasAltin, gramAltin, dolar, euro gibi anahtarlar. Her biri alis ve satis değerleri içerir. Tarih ve zaman damgası metadata olarak eklenir.
Fiyat güncelleme endpoint’i: tetikleme sonrası job_id veya status döner. Asenkron işlemlerde polling veya webhook ile sonuç takip edilir. Hata durumunda error kodu ve mesaj döner.
Hata Yakalama Senaryoları
HTTP 401: Geçersiz veya eksik API anahtarı. Çözüm: Anahtarı kontrol edin, yeniden oluşturun.
HTTP 429: Rate limit aşıldı. Çözüm: İstek sıklığını azaltın, cache kullanın.
HTTP 500: Sunucu hatası. Çözüm: Kısa süre sonra tekrar deneyin; kalıcıysa destek ile iletişime geçin.
Timeout: Ağ veya sunucu yavaşlığı. Çözüm: 5 ila 10 saniye timeout tanımlayın; retry mekanizması ekleyin.
JSON parse hatası: Beklenmeyen yanıt formatı. Çözüm: try-catch ile yakalayın; önceki cache değerini kullanın.
Apı Karşılaştırma Tablosu
| Özellik | ONEPiR API | TCMB Açık Veri | Manuel |
|---|---|---|---|
| Format | JSON | XML/CSV | Excel |
| Auth | API Key | Yok | Yok |
| Rate limit | Var | Yok | Yok |
| Dokümantasyon | Var | Var | Yok |
| Anlık güncelleme Var | Günlük | Manuel |
Entegrasyon Kontrol Listesi
1. API anahtarı panelden alındı mı?
2. Base URL ve endpoint’ler dokümantasyondan doğrulandı mı?
3. Authentication header doğru formatta mı?
4. Hata durumları (401, 429, 500) handle ediliyor mu?
5. Timeout ve retry mekanizması var mı?
6. API anahtarı sunucu tarafında mı tutuluyor?
Sıkça Sorulan Sorular
API erişimi nasıl sağlanır?
ONEPiR.com panelinden API anahtarı alınır. HTTP isteklerinde Authorization header’ında Bearer token veya x-api-key ile gönderilir. Base URL dokümantasyonda belirtilir.
JSON response formatı nedir?
Kur endpoint’i kurlar nesnesi döner; içinde hasAltin, gramAltin, dolar, euro ve her biri için alis, satis değerleri vardır. Tarih ve zaman damgası metadata içindedir.
Rate limit var mı?
Evet. Dakikada veya günde maksimum istek sayısı vardır. Aşımda HTTP 429 döner. Cache kullanımı önerilir.
API ücretsiz mi?
Modüller ücretsizdir. API çağrıları kontör tüketir. Hediye kontör ile başlangıç yapılır.
Hangi diller desteklenir?
REST API olduğu için her dilde HTTP isteği atılabilir. Node.js, Python, PHP, cURL örnekleri yaygındır.
Webhook desteği var mı?
Asenkron işlemlerde webhook veya polling ile sonuç takip edilebilir. Detay dokümantasyonda yer alır.
Uygulama Adımları (Howto)
1. Kayıt ve API anahtarı alın: ONEPiR.com üzerinden ücretsiz hesap oluşturun. Panelden API anahtarı oluşturun ve güvenli yerde saklayın.
2. Base URL ve endpoint’leri inceleyin: Dokümantasyondaki base URL (ör. https://api.ONEPiR.com) ve endpoint yollarını (ör. /currency, /rates) not alın.
3. İlk isteği atın: cURL veya Postman ile test isteği yapın. Authorization header’ında Bearer token gönderin. Yanıt formatını inceleyin.
4. Uygulamanıza entegre edin: Tercih ettiğiniz dilde (Node.js, Python vb.) HTTP istemcisi kullanarak istek atın. JSON parse ve hata yönetimi ekleyin.
5. Cache ve retry uygulayın: Yüksek trafik için cache ekleyin. 429 ve 500 hatalarında exponential backoff ile retry yapın.
6. Production’da test edin: Canlı ortamda düşük trafikle başlayın. Rate limit ve yanıt sürelerini gözlemleyin.
Yaygın Hatalar
Anahtarı URL’de göndermek: Güvenlik riski. Her zaman header kullanın.
İstemci tarafında anahtar: JavaScript veya mobil uygulamada açıkta bırakmayın. Sunucu proxy kullanın.
Cache kullanmamak: Rate limit aşımı ve gereksiz yük. En az 5 dakika cache önerilir.
Timeout yok: Ağ sorunlarında uygulama takılabilir. 5-10 saniye timeout tanımlayın.
Saha Gözlemleri
Geliştiriciler genelde ilk entegrasyonda authentication formatını yanlış gönderir. Bearer kelimesi ile anahtar arasında boşluk olmalıdır. Bazı API’ler x-api-key tercih eder; dokümantasyonu kontrol edin.
Ne Zaman Kullanılmamalı
Sadece panel üzerinden fiyat yönetimi yapan kullanıcılar API’ye ihtiyaç duymaz. Özel yazılım, raporlama veya çoklu kanal senaryolarında API anlamlıdır.
Özet Ve Aksiyon Çağrısı
ONEPiR API, kur verisi ve fiyat güncelleme işlemlerini programatik olarak yapan geliştiriciler için REST tabanlı erişim sunar. Authentication, hata yönetimi ve rate limit kurallarına uyulmalıdır.