الاستعلام الدوري من API (Polling)
الاستعلام الدوري من API (API polling) هو الحصول على بيانات حديثة عبر طلبات متكررة بجدول زمني: كل N ثانية يسأل العميل الخادم عما تغيّر. تعمل البوتات ولوحات المتابعة هكذا مع REST API الذي لا يرسل شيئاً من تلقاء نفسه: كل استعلام هو HTTP GET عادي.
الفاصل وحداثة البيانات
لا فائدة من الاستعلام بوتيرة أسرع من تحديث البيانات: سيعيد الخادم اللقطة نفسها. في Genesis API تعتمد حداثة البيانات على الخطة: يُحدَّث الإخراج كل 60 ثانية في Trial و30 في Start و10 في Pro و5 في Max، وتأتي هذه القيمة في الحقل meta.freshness_sec. وقت بناء اللقطة في meta.updated_at؛ فإذا تكررت القيمة نفسها في استجابتين متتاليتين فالطلب الثاني كان هدراً.
مثال افتراضي: في Trial يستعلم بوت من نقطة نهاية كل 10 ثوانٍ. من الطلبات الستة في الدقيقة يجلب واحد فقط بيانات جديدة؛ والخمسة الباقية تكرر اللقطة وتستهلك الحصة، ما لم يرسل البوت If-None-Match.
import os
import time
import requests
URL = "https://api.genesisarbitrage.com/v1/arbitrage/spot-spot"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
while True:
r = requests.get(URL, headers=HEADERS,
params={"min_spread": 1}, timeout=10)
if r.status_code in (429, 503):
time.sleep(int(r.headers.get("Retry-After", "5")))
continue
r.raise_for_status()
meta = r.json()["meta"]
print("pairs:", meta["count"], "snapshot:", meta["updated_at"])
# الاستعلام أسرع من خطوة تحديث الخطة بلا جدوى
time.sleep(meta["freshness_sec"])
كم استدعاء يستهلك الاستعلام الدوري
الاستعلام من نقطة نهاية واحدة كل 10 ثوانٍ: 2,592,000 ÷ 10 = 259,200 استدعاء خلال 30 يوماً. وحصة Genesis API تغطي 30 يوماً أيضاً.
| الخطة والحصة | الفاصل = الحداثة | الاستدعاءات لكل نقطة نهاية | نقاط النهاية ضمن الحصة |
|---|---|---|---|
| Trial، 500K | 60 ث | 43,200 | 11 |
| Start، 2M | 30 ث | 86,400 | 23 |
| Pro، 5M | 10 ث | 259,200 | 19 |
| Max، 10M | 5 ث | 518,400 | 19 |
لا يأخذ الحساب استجابات 304 في الاعتبار. في Pro تعني 19 نقطة نهاية كل 10 ثوانٍ في المتوسط 1.9 طلب في الثانية مقابل حد قدره 5. وزّع الطلبات على الزمن: 19 طلباً دفعة واحدة تتجاوز الحد، وسيجيب الخادم بـ HTTP 429.
الاستعلام الدوري وWebSocket وWebhook
| الأسلوب | من يبدأ النقل | يناسب |
|---|---|---|
| الاستعلام الدوري | العميل، بجدول زمني | بيانات تتحدث بخطوة معروفة؛ يكفي أي عميل HTTP |
| WebSocket | الخادم، عبر اتصال مفتوح | تدفق مستمر من التغييرات: دفاتر أوامر البورصات وصفقاتها |
| Webhook | الخادم، بطلب إلى رابطك | أحداث نادرة، إذا كانت لديك نقطة HTTPS عامة |
لا يوجد في Genesis API لا WebSocket ولا Webhook: البيانات تُقدَّم عبر REST، وتحدد الخطة الحداثة. الاستعلام بوتيرة meta.freshness_sec هو الأسلوب المعتمد، وطرق تقليل الحركة والاستدعاءات في كيف تستعلم من API دوريا دون الوصول إلى الحدود.
انظر أيضاً: حد المعدل، الخطط والحدود في التوثيق، صيغة الاستجابة، حدود Genesis API.
أسئلة وأجوبة
كل كم ثانية أستعلم من Genesis API؟
بوتيرة لا تزيد على meta.freshness_sec في خطتك: كل 60 ثانية في Trial و30 في Start و10 في Pro و5 في Max. الاستعلام الأسرع يعيد البيانات نفسها.