تخطى إلى المحتوى

دليل سير عمل API

ماذا تريد أن تبني؟

اختر النتيجة الأقرب لوظيفتك. يمنحك كل مسار طلباً واحداً للعمل، وما يجب أن تحتويه الاستجابة، وكيفية التحقق من عمله، والخطوة المفيدة التالية.

خمسة مسارات عملية

ابدأ بالنتيجة، وليس بقائمة نقاط النهاية.

Selected: Plan release jobs

تجربة API لمدة 14 يوم الخاصة بك

انتقل من مجرد الطلب الأول إلى مهمة تستحق الاستمرار.

الهدف ليس زيارة كل صفحة منتج. الهدف هو إكمال عمل API مفيد وموثق، والعودة في يوم آخر، والمغادرة مع مجموعة بيانات أو سير عمل تطبيق قابل للتكرار.

تحقق من تقدم API

يوم 0

إثبات الوصول

أنشئ المفتاح، أكمل طلباً واحداً موثقاً، واحفظ الاستجابة الأولى مع بياناتها الوصفية.

فتح الخطوة ←

أيام 1-2

اجعل الطلب موثوقاً

حل مشكلات المصادقة أو التصفية وحوّل أول سكربت إلى وظيفة مكررة مسمى.

فتح الخطوة ←

أيام 3-4

إضافة توقيت الإصدار

استخدم التقويم كعائلة نقاط نهاية ثانية وجدول تشغيل API المفيد التالي.

فتح الخطوة ←

أيام 5-7

بناء مخرجات البحث

أضف التوقعات أو مجموعة صغيرة من السلاسل الكلية، ثم قم بإنشاء مقارنة واحدة أو جدول أو بطاقة أداء محفوظة.

فتح الخطوة ←

أيام 8-10

أتمتة التحديثات

اختر REST المجدول، أو SSE، أو webhooks وأكمل تشغيل API ناجح آخر في يوم مختلف.

فتح الخطوة ←

أيام 11-13

تحصين العميل

أضف مهلات زمنية، وإعادة محاولات محدودة، والتحقق من صحة الاستجابة، وتسجيل البيانات الآمن للمؤهلات، ومراقبة البيانات القديمة.

فتح الخطوة ←

يوم 14

مراجعة الأدلة

تأكد من أن API يوفر وظيفة قابلة للتكرار سيحتفظ بها فريقك، ثم اختر مجموعة البيانات التالية أو سير عمل التطبيق.

فتح الخطوة ←

Scheduled workflow

Plan around confirmed releases

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.

15 minutes Core workflow التقويمالإعلانات

مثال عملي

احتفظ بمفتاحك في 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 جاهزاً للإنتاج أضف مهلات زمنية، وإعادة محاولات محدودة، وتخزين مؤقت، وطلبات مشروطة، ونمط التسليم الصحيح. فتح الدليل ←