יום 0
הוכח גישה
צור את המפתח, בצע בקשה מאומתת אחת, ושמור את התגובה הראשונה עם המטא-נתונים שלה.
פתח שלב ←מדריך תהליך עבודה של API
בחר את התוצאה הקרובה ביותר למשימה שלך. כל נתיב נותן לך בקשה אחת עובדת, מה התגובה צריכה להכיל, איך לבדוק שזה עבד, והשלב המועיל הבא.
חמישה נתיבים מעשיים
Selected: Troubleshoot a request
תקופת הניסיון של API למשך 14 ימים שלך
המטרה אינה לבקר בכל דף מוצר. המטרה היא להשלים עבודת API מאומתת ומועילה, לחזור ביום אחר, ולצאת עם סט נתונים או תהליך עבודה של אפליקציה שניתן לחזור עליו.
יום 0
צור את המפתח, בצע בקשה מאומתת אחת, ושמור את התגובה הראשונה עם המטא-נתונים שלה.
פתח שלב ←ימים 1-2
פתור בעיות אימות או סינון והפוך את הסקריפט הראשון למשימה שמימה שניתן לחזור עליה.
פתח שלב ←ימים 3-4
השתמש בלוח השנה כמשפחת נקודות קצה שנינית ותזמן את הרצת ה-API המועילה הבאה.
פתח שלב ←ימים 5-7
הוסף ציפיות או קבוצה קטנה של סדרות מאקרו, ואז הפק השוואה, טבלה או כרטיס ניקוד שמור אחד.
פתח שלב ←ימים 8-10
בחר REST, SSE מתוזמנים, או webhooks והשלם הרצה מוצלחת נוספת של API ביום אחר.
פתח שלב ←ימים 11-13
הוסף פסק זמן (timeouts), ניסיונות חוזרים מוגבלים, אימות תגובה, רישום (logging) בטוח לסיסמאות וניטור נתונים לא עדכניים.
פתח שלב ←יום 14
אשרו שה-API מספק עבודה ניתנת לשחזור שהצוות שלכם ישמור, ואז בחרו את סט הנתונים או תהליך עבודת האפליקציה הבא.
פתח שלב ←Request help
Inspect the status and a short error body, then follow the matching fix. Never paste an API key or a full authenticated URL into a support message.
דוגמה עובדת
שמור את המפתח שלך ב FXMD_API_KEY; לעולם אל תדביק אותו בבקרת מקור (source control).
import os
import requests
key = os.getenv("FXMD_API_KEY", "").strip()
if not key:
raise RuntimeError("FXMD_API_KEY is not set")
response = requests.get(
"https://api.fxmacrodata.com/v1/announcements/eur/inflation",
params={"api_key": key, "limit": 1},
timeout=20,
)
print(response.status_code, response.text[:300])
תוצאה צפויה: A 200 confirms the key and path work. A 401 or 403 points to authentication or access, a 404 to the path, and a 429 to request pacing.
כאשר הסקריפט הראשון הופך למערכת אמיתית
השתמשו במדריכים אלו כאשר תגובה נכשלת, אינה מחזירה נתונים, או זקוקה לבקרות ייצור כגון מטמון (caching), פסק זמן (timeouts), ניסיונות חוזרים ומסירת אירועים.
| מדריך | השתמש בזה כאשר | התחל |
|---|---|---|
| אבחון תגובה שנכשלה או ריקה | הפרד בין בעיות אימות, גישה, נתיב, הגבלת קצב וזמינות נתונים מבלי לחשוף את המפתח שלך. | פתח מדריך ← |
| הפוך לקוח API למוכן לייצור | הוסף הגבלות זמן (timeouts), ניסיונות חוזרים מוגבלים, מטמון (caching), בקשות מותנות ותבנית מסירה נכונה. | פתח מדריך ← |