حدود معدل الطلبات
لكل مفتاح حدان: طلبات في الدقيقة وفي اليوم (يُحسب اليوم بتوقيت UTC). قيم مفتاحك يعرضها GET /me في الحقل rateLimit (rpm وrpd).
يحمل كل رد على استدعاء موثق بمفتاح حالة الحد الأقرب إلى النفاد، بما في ذلك تنزيل الملفات (فهو أيضا يُحسب ضمن حد المعدل). الردود الصادرة قبل فحص المفتاح أو الحد لا تحمل هذه الترويسات: المفتاح غير الصالح (401)، والجسم التالف (400)، والمسار غير المعروف (404)، ومعاملات الاستعلام غير الصالحة (400 validation)، وغياب النطاق (403 forbidden_scope)، والكتابة المرفوضة لمفتاح الاختبار (403).
في المتصفح (CORS) يمكن قراءة الترويسات RateLimit-* وRetry-After وGrem-Sandbox وX-Request-Id وContent-Range.
RateLimit-Limit: 60
RateLimit-Remaining: 12
RateLimit-Reset: 41
| الترويسة | المعنى |
|---|---|
RateLimit-Limit | الطلبات المسموح بها في النافذة الحالية |
RateLimit-Remaining | الطلبات المتبقية |
RateLimit-Reset | الثواني حتى إعادة ضبط النافذة |
فوق الحد يصل 429 مع title: rate_limited وترويسة Retry-After. حد معدل الطلبات حماية تقنية ولا يخصم أي مبلغ أبدا.
راقب RateLimit-Remaining ووزّع الطلبات على الوقت. الاستعلام عن حالة المهام يُحتسب أيضا ضمن الحد رغم أنه مجاني: لا تستعلم أكثر من مرة كل بضع ثوان، أو انتقل إلى webhooks.
الفوترة
لا توجد خطة API منفصلة: الوصول جزء من اشتراكك، والإجراءات المدفوعة تُخصم من المحفظة نفسها كما في لوحة التحكم.
للاستدعاء المدفوع جزءان:
- استدعاء API. من حصة الاستدعاءات المضمنة في الخطة. وما يتجاوزها يُحتسب حسب الاستخدام.
- سعر الأداة: بقدر ما يكلفه الإجراء نفسه في لوحة التحكم (من الحصة المضمنة أو من المحفظة).
حصة استدعاءات API حسب الخطة:
| الخطة | استدعاءات API شهريا |
|---|---|
| Free | 100 |
| Start | 5,000 |
| PRO | 25,000 |
| MAX | 100,000 |
| Agency Start | 50,000 |
| Agency Growth | 250,000 |
| Agency Scale | غير محدودة ضمن الاستخدام العادل |
الخطط الأخرى، وحصص الأدوات وأسعارها الحالية، موجودة في صفحة الخطط في لوحة التحكم.
ما المدفوع وما المجاني
فئة الفوترة لكل عملية موجودة في /openapi.json، الحقل x-grem-billing: free أو api_call أو api_call+sku:... (استدعاء مع سعر الأداة).
| مدفوع | مجاني |
|---|---|
تشغيل الأدوات (POST إلى التقييم والنصوص والفيديو والصور وPDF والموقع وغيرها): استدعاء + سعر الأداة | كل عمليات القراءة (GET)، بما فيها الاستعلام عن المهام والتنزيلات |
| النشرة وتأكيد مراجعة التقرير: الاستدعاء فقط | العقارات: الإنشاء والتعديل والحذف |
| رسالة المحادثة: استدعاء + سعر الرسالة | العملاء المحتملون وSwipe Match: الإنشاء والتعديل والأحداث |
| إنشاء جلسات المحادثة وتعديلها وحذفها: الاستدعاء فقط | رفع الصور |
| إدارة webhooks |
الطلب المرفوض (4xx أو 5xx) لا يستهلك استدعاء API. الاستثناء هو 502 provider_error بعد انتهاء المهلة: قد ينتهي العمل ويُخصم ثمنه، فتحقق من GET /works (تحسين الصور والموقع والمسودة: في لوحة التحكم أو بين عقاراتك). وإعادة التقييم السريع بالمفتاح Idempotency-Key نفسه تعيد النتيجة مجانا (لا التقييم ولا استدعاء API)؛ أما في الأدوات الأخرى فيبقى المفتاح محجوزا 15 دقيقة بعد انتهاء المهلة، فتحقق من النتيجة بدل الإعادة.
الاستدعاءات والإنفاق والأخطاء لكل مفتاح تظهر في لوحة التحكم، صفحة API، تبويب التحليلات.
مقالات ذات صلة
- الأخطاء:
402و429. - عدم التكرار: إعادة آمنة دون خصم مزدوج.