Gün 0
Erişimi kanıtla
Anahtarı oluşturun, bir kimliği doğrulanmış istek tamamlayın ve ilk yanıtı meta verileriyle birlikte kaydedin.
Adımı aç →API iş akışı kılavuzu
Ne inşa etmek istiyorsunuz?
İşinize en yakın sonucu seçin. Her yol size bir çalışan istek, yanıtın ne içermesi gerektiği, nasıl çalıştığını kontrol edeceğiniz ve bir sonraki yararlı adımı sunar.
Beş pratik yol
Uç nokta listesiyle değil, sonuçla başlayın.
Selected: Harden a client
Yol 1
Makro veri çek
Temiz bir zaman serisi alın ve kaynak ile kalite meta verilerini yanında tutun.
Yol 2
Yayın işlerini planlayın
Bilinen yayın saatleri etrafında hedeflenmiş işler çalıştırmak için yayın takvimini kullanın.
Yol 3
Sürprizleri ölçün
İleriye dönük bakış sapması (lookahead bias) oluşturmadan, yayınlanmış değere ön yayın tahminlerini dahil edin.
Yol 4
Canlı güncellemeler alın
SSE'u bir geçersiz kılma sinyali olarak kullanın, ardından REST'den tam kaydı getirin.
Yol 5
Bir makro model oluşturun
Küçük bir ilgili göstergeler grubunu, kaynak etiketli bir para birimi karnesine dönüştürün.
14 günlük API denemeniz
İlk istekten, saklamaya değer bir işe geçin.
Hedef her ürün sayfasını ziyaret etmek değildir. Yararlı, kimliği doğrulanmış API işini tamamlamak, başka bir gün geri dönmek ve tekrarlanabilir bir veri seti veya uygulama iş akışı ile ayrılmaktır.
Gün 1-2
İsteği güvenilir hale getirin
Kimlik doğrulama veya filtre sorunlarını çözün ve ilk betiği isimlendirilmiş, tekrarlanabilir bir işe dönüştürün.
Adımı aç →Günler 3-4
Yayın zamanlaması ekle
Takvimi ikinci bir uç nokta ailesi olarak kullanın ve bir sonraki yararlı API çalışmasını planlayın.
Adımı aç →Günler 5-7
Araştırma çıktısını oluşturun
Beklentileri veya küçük bir makro serisi grubunu ekleyin, ardından bir kayıtlı karşılaştırma, tablo veya puan tablosu oluşturun.
Adımı aç →Gün 8-10
Güncellemeleri otomatize edin
Planlanmış REST, SSE veya webhook'ları seçin ve farklı bir günde başka bir başarılı API çalışması tamamlayın.
Adımı aç →Günler 11-13
İstemciyi güçlendirin
Zaman aşımları, sınırlı denemeler, yanıt doğrulama, kimlik bilgisi güvenli günlükleme ve bayat veri izleme ekleyin.
Adımı aç →Gün 14
Kanıtları incele
API'nin ekibinizin sürdüreceği tekrarlanabilir bir iş sağladığını onaylayın, ardından bir sonraki veri setini veya uygulama iş akışını seçin.
Adımı aç →Production readiness
Bir API istemcisini üretime hazır hale getirin
Production reliability comes from treating status codes differently, keeping retries bounded, reusing ETags, and choosing scheduled REST, SSE, or webhooks for the job.
Çalışan örnek
Anahtarınızı şurada tutun FXMD_API_KEY; asla kaynak kontrolüne yapıştırmayın.
import os
import requests
from urllib3.util.retry import Retry
session = requests.Session()
retry = Retry(total=3, backoff_factor=0.5, status_forcelist=(429, 502, 503, 504))
session.mount("https://", requests.adapters.HTTPAdapter(max_retries=retry))
response = session.get(
"https://api.fxmacrodata.com/v1/announcements/eur/inflation",
params={"api_key": os.environ["FXMD_API_KEY"], "limit": 5},
headers={"Accept-Encoding": "gzip"},
timeout=(3.05, 20),
)
response.raise_for_status()Beklenen sonuç: A bounded client that handles transient failures without retry storms and is ready to add ETag-based conditional refreshes.
İlk betik gerçek bir sistem haline geldiğinde
Sorun giderme ve üretim rehberliği
Bir yanıt başarısız olduğunda, veri döndürmediğinde veya önbelleğe alma, zaman aşımı, yeniden deneme ve olay teslimi gibi üretim kontrollerine ihtiyaç duyulduğunda bu kılavuzları kullanın.
| Rehber | Şu durumlarda kullanın | Başlat |
|---|---|---|
| Başarısız veya boş bir yanıtı teşhis edin | Anahtarınızı ifşa etmeden ayrı kimlik doğrulama, erişim, yol, hız sınırı ve veri kullanılabilirliği sorunlarını çözün. | Kılavuzu aç → |
| Bir API istemcisini üretime hazır hale getirin | Zaman aşımları, sınırlı denemeler, önbelleğe alma, koşullu istekler ve doğru teslimat modelini ekleyin. | Kılavuzu aç → |