يوم 0
إثبات الوصول
أنشئ المفتاح، أكمل طلباً واحداً موثقاً، واحفظ الاستجابة الأولى مع بياناتها الوصفية.
فتح الخطوة ←دليل سير عمل API
اختر النتيجة الأقرب لوظيفتك. يمنحك كل مسار طلباً واحداً للعمل، وما يجب أن تحتويه الاستجابة، وكيفية التحقق من عمله، والخطوة المفيدة التالية.
خمسة مسارات عملية
Selected: Plan release jobs
تجربة API لمدة 14 يوم الخاصة بك
الهدف ليس زيارة كل صفحة منتج. الهدف هو إكمال عمل API مفيد وموثق، والعودة في يوم آخر، والمغادرة مع مجموعة بيانات أو سير عمل تطبيق قابل للتكرار.
يوم 0
أنشئ المفتاح، أكمل طلباً واحداً موثقاً، واحفظ الاستجابة الأولى مع بياناتها الوصفية.
فتح الخطوة ←أيام 1-2
حل مشكلات المصادقة أو التصفية وحوّل أول سكربت إلى وظيفة مكررة مسمى.
فتح الخطوة ←أيام 3-4
استخدم التقويم كعائلة نقاط نهاية ثانية وجدول تشغيل API المفيد التالي.
فتح الخطوة ←أيام 5-7
أضف التوقعات أو مجموعة صغيرة من السلاسل الكلية، ثم قم بإنشاء مقارنة واحدة أو جدول أو بطاقة أداء محفوظة.
فتح الخطوة ←أيام 8-10
اختر REST المجدول، أو SSE، أو webhooks وأكمل تشغيل API ناجح آخر في يوم مختلف.
فتح الخطوة ←أيام 11-13
أضف مهلات زمنية، وإعادة محاولات محدودة، والتحقق من صحة الاستجابة، وتسجيل البيانات الآمن للمؤهلات، ومراقبة البيانات القديمة.
فتح الخطوة ←يوم 14
تأكد من أن API يوفر وظيفة قابلة للتكرار سيحتفظ بها فريقك، ثم اختر مجموعة البيانات التالية أو سير عمل التطبيق.
فتح الخطوة ←Scheduled workflow
The calendar tells your scheduler when a release is expected. Your job can then fetch the full announcement record after publication instead of polling every series continuously.
مثال عملي
احتفظ بمفتاحك في FXMD_API_KEY; لا تقم أبداً بلصقها في نظام التحكم في المصدر.
from datetime import date, timedelta
import os
import requests
events = requests.get(
"https://api.fxmacrodata.com/v1/calendar/eur",
params={
"api_key": os.environ["FXMD_API_KEY"],
"start_date": date.today().isoformat(),
"end_date": (date.today() + timedelta(days=14)).isoformat(),
"timezone": "UTC",
},
timeout=20,
).json()["data"]
print(events[:3])
النتيجة المتوقعة: Upcoming EUR releases with dates, times, indicator paths, and confirmation fields that your scheduler can evaluate before creating a job.
عندما يصبح السكربت الأول نظاماً حقيقياً
استخدم هذه الأدلة عندما يفشل الرد، أو لا يعيد أي بيانات، أو يحتاج إلى ضوابط الإنتاج مثل التخزين المؤقت، ومهلات الانتظار، وإعادة المحاولة، وتسليم الأحداث.
| دليل | استخدمه عندما | ابدأ |
|---|---|---|
| تشخيص استجابة فاشلة أو فارغة | فصل مشكلات المصادقة، والوصول، والمسار، وتحديد معدل الطلبات، وتوافر البيانات دون الكشف عن مفتاحك. | فتح الدليل ← |
| اجعل عميل API جاهزاً للإنتاج | أضف مهلات زمنية، وإعادة محاولات محدودة، وتخزين مؤقت، وطلبات مشروطة، ونمط التسليم الصحيح. | فتح الدليل ← |
التغطية، والترخيص، والتسعير، والتكامل. سجل الدخول للسؤال؛ يمكن للمشتركين استرداد البيانات.
تستخدم الإجابات AI. تُرسل الأسئلة إلى Google وتُحفظ في حسابك حتى نتمكن من المتابعة. لا تدرج المفاتيح أبدًا. الخصوصية