Gün 0
Girişi sübut edin
Açarı yaradın, bir autentifikasiya olunmuş sorğu tamamlayın və ilk cavabı metadata ilə birlikdə yadda saxlayın.
Addım aç →API iş axını təlimatı
Nə qurmaq istəyirsiniz?
İşinizə ən yaxın nəticəni seçin. Hər bir yol sizə bir işlək sorğu, cavabın nəyi ehtiva etməli olduğu, onun işlədiyini necə yoxlamaq və növbəti faydalı addımı verir.
Beş praktiki yol
Endpoint siyahısı ilə deyil, nəticə ilə başlayın.
Seçildi: Makro məlumatları əldə et
Yol 1
Makro məlumatları əldə edin
Təmiz zaman sıralamasını əldə edin və mənbə və keyfiyyət metadatalarını onun yanında saxlayın.
Yol 2
Buraxılış işlərini planlaşdırın
Məlum dərc vaxtları ətrafında hədəflənmiş işlər icra etmək üçün buraxılış təqviminindən istifadə edin.
Yol 3
Sürprizləri ölçün
Gözlənilən nəticə qərəzi (lookahead bias) yaratmadan, buraxılışdan əvvəlki proqnozları dərc edilmiş dəyərə birləşdirin.
Yol 4
Canlı yeniləmələr alın
SSE əlavə etmə siqnalı kimi istifadə edin, sonra isə tam qeydi REST vasitəsilə əldə edin.
Yol 5
Makro model qurun
Kiçik bir əlaqəli göstəricilər qrupunu mənbə etiketli valyuta göstəricisinə çevirin.
Sizin 14 günlük API sınaq müddətiniz
İlk sorğudan saxlanmağa dəyər bir işə keçin.
Məqsəd hər bir məhsul səhifəsini ziyarət etmək deyil. Məqsəd faydalı autentifikasiya olunmuş API işini tamamlamaq, başqa bir gün geri dönmək və təkrar oluna bilən bir məlumat dəsti və ya tətbiq iş axını ilə ayrılmaqdır.
Günlər 1-2
Sorğunu etibarlı edin
Autentifikasiya və ya filtr problemlərini həll edin və ilk skripti adlandırılmış təkrar oluna bilən işə çevirin.
Addım aç →Günlər 3-4
Buraxılış vaxtını əlavə edin
Təqvimi ikinci endpoint ailəsi kimi istifadə edin və növbəti faydalı API işini planlaşdırın.
Addım aç →Günlər 5-7
Tədqiqat nəticəsini yaradın
Gözləntiləri və ya kiçik bir makro seriyalar qrupunu əlavə edin, sonra bir yadda saxlanılmış müqayisə, cədvəl və ya qiymətləndirmə kartı yaradın.
Addım aç →Günlər 8-10
Yenilənmələri avtomatlaşdırın
Planlaşdırılmış REST, SSE və ya vebhook-ları seçin və fərqli bir gündə digər uğurlu API icrasını tamamlayın.
Addım aç →Günlər 11-13
Klienti möhkəmləndirin
Timeout-lar, məhdud edilmiş təkrar cəhdlər, cavab validasiyası, etibarlı loqlama və köhnəlmiş məlumat monitorinqi əlavə edin.
Addım aç →Gün 14
Sübutları nəzərdən keçirin
API komandanızın davam edəcəyi təkrar oluna bilən bir iş təmin etdiyini təsdiqləyin, sonra növbəti məlumat dəstini və ya tətbiq iş axınını seçin.
Addım aç →İlk sorğu
Makro tarixçəni gətirin və yadda saxlayın
Artıq anladığınız bir valyuta və indikatorla başlayın. Bu, daha çox seriya əlavə etməzdən əvvəl autentifikasiyanı, cavab formasını, səhifələməni və saxlanmanı asan yoxlamağa imkan verir.
İşlək nümunə
Açarınızı burada saxlayın FXMD_API_KEY; onu heç vaxt mənbə nəzarətinə (source control) yapışdırmayın.
import os
import requests
response = requests.get(
"https://api.fxmacrodata.com/v1/announcements/eur/inflation",
params={"api_key": os.environ["FXMD_API_KEY"], "limit": 5},
timeout=20,
)
response.raise_for_status()
payload = response.json()
print(payload["data"][0])Gözlənilən nəticə: Son EUR inflyasiya müşahidələri ilə birlikdə seriyanı, mənbəni, səhifələməni və məlumat keyfiyyətini təsvir edən cavab metadatası ilə bir 200 cavabı.
İlk skript real sistemə çevrildikdə
Problemlərin həlli və istehsalat rəhbərliyi
Cavab uğursuz olduqda, məlumat qaytarmadıqda və ya keşləmə, vaxt aşımı, təkrar cəhd və hadisə çatdırılması kimi istehsalat nəzarəti tələb etdikdə bu bələdçilərdən istifadə edin.
| Bələdçi | Bunu istifadə edin | Başla |
|---|---|---|
| Uğursuz və ya boş cavabı diaqnoz edin | Açarınızı ifşa etmədən ayrı autentifikasiya, giriş, yol, sürət limiti və məlumat əlçatanlığı problemlərini həll edin. | Bələdçini aç → |
| Bir API müştərisini istehsalata hazır hala gətirin | Taymautlar, məhdud sayda təkrar cəhdlər, keşləmə, şərti sorğular və düzgün çatdırılma modelini əlavə edin. | Bələdçini aç → |