Hari 0
Buktikan akses
Buat kunci, selesaikan satu permintaan terautentikasi, dan simpan respons pertama beserta metadatanya.
Buka langkah →Panduan alur kerja API
Apa yang ingin Anda bangun?
Pilih hasil yang paling dekat dengan pekerjaan Anda. Setiap path memberi Anda satu permintaan yang berfungsi, apa yang harus ada dalam respons, cara memeriksa apakah itu berhasil, dan langkah berguna berikutnya.
Lima jalur praktis
Mulailah dengan hasilnya, bukan daftar endpoint.
Selected: Measure surprises
Jalur 1
Ambil data makro
Dapatkan deret waktu yang bersih dan simpan metadata sumber serta kualitas di sampingnya.
Jalur 2
Rencanakan pekerjaan rilis
Gunakan kalender rilis untuk menjalankan pekerjaan terarah di sekitar waktu publikasi yang diketahui.
Jalur 3
Ukur kejutan
Gabungkan prakiraan pra-rilis ke nilai yang diterbitkan tanpa memperkenalkan bias lookahead.
Jalur 4
Terima pembaruan langsung
Gunakan SSE sebagai sinyal pembatalan, lalu ambil catatan lengkap dari REST.
Jalur 5
Bangun model makro
Ubah sekelompok kecil indikator terkait menjadi kartu skor mata uang berlabel sumber.
Uji coba API 14 hari Anda
Berpindah dari permintaan pertama ke pekerjaan yang layak dipertahankan.
Tujuannya bukan untuk mengunjungi setiap halaman produk. Tujuannya adalah untuk menyelesaikan pekerjaan API terautentikasi yang berguna, kembali di hari lain, dan pergi dengan dataset atau alur kerja aplikasi yang dapat diulang.
Hari 1-2
Buat permintaan menjadi andal
Selesaikan masalah autentikasi atau filter dan ubah skrip pertama menjadi pekerjaan bernama yang dapat diulang.
Buka langkah →Hari 3-4
Tambahkan waktu rilis
Gunakan kalender sebagai keluarga endpoint kedua dan jadwalkan run API berguna berikutnya.
Buka langkah →Hari 5-7
Bangun output penelitian
Tambahkan ekspektasi atau sekelompok kecil seri makro, lalu hasilkan satu perbandingan, tabel, atau kartu skor yang disimpan.
Buka langkah →Hari 8-10
Otomatiskan pembaruan
Pilih REST, SSE, atau webhook terjadwal dan selesaikan API run yang berhasil lainnya pada hari yang berbeda.
Buka langkah →Hari 11-13
Perkuat klien
Tambahkan timeout, upaya pengulangan terbatas, validasi respons, logging yang aman untuk kredensial, dan pemantauan data usang.
Buka langkah →Hari 14
Tinjau bukti
Konfirmasikan bahwa API menyediakan pekerjaan berulang yang akan dipertahankan tim Anda, lalu pilih dataset atau alur kerja aplikasi berikutnya.
Buka langkah →Expectations workflow
Compare forecasts with actual releases
Use predictions before the event, preserve the forecast timestamp, then join the released observation by announcement identity for a repeatable surprise series.
Contoh kerja
Simpan kunci Anda di FXMD_API_KEY; jangan pernah menempelkannya ke dalam kontrol sumber.
import os
import requests
params = {
"api_key": os.environ["FXMD_API_KEY"],
"pre_release_only": "true",
"limit": 5,
}
response = requests.get(
"https://api.fxmacrodata.com/v1/predictions/eur/inflation",
params=params,
timeout=20,
)
response.raise_for_status()
print(response.json()["data"][0])Hasil yang diharapkan: Recent EUR inflation release groups with source-labelled forecasts that were recorded before each announcement.
Ketika skrip pertama menjadi sistem nyata
Pemecahan masalah dan panduan produksi
Gunakan panduan ini jika respons gagal, tidak mengembalikan data, atau memerlukan kontrol produksi seperti caching, timeout, retry, dan pengiriman event.
| Panduan | Gunakan saat | Mulai |
|---|---|---|
| Diagnosis respons yang gagal atau kosong | Masalah autentikasi, akses, jalur, batas-kecepatan, dan ketersediaan data yang terpisah tanpa mengekspos kunci Anda. | Buka panduan → |
| Buat klien API siap produksi | Tambahkan timeout, retries terbatas, caching, permintaan kondisional, dan pola pengiriman yang tepat. | Buka panduan → |