الوصول عبر API

الخطوات

1. ١

   أنشئ Key من صفحة API واحفظ بيانات الاعتماد الكاملة التي تظهر مرة واحدة في مدير أسرار الخادم.

2. ٢

   اقرأ الإمكانات أولاً وأنشئ الطلب وفق معلمات النموذج والحدود المعادة في ذلك الوقت.

3. ٣

   استخدم Idempotency-Key فريداً لكل إرسال منطقي وحدد الحد المقبول في maxPoints.

4. ٤

   افحص الحالة بمعرف المهمة المعاد، ثم استلم النتيجة بعد اكتمالها فقط.

5. ٥

   اقرأ expiresAt في بيانات التسليم ونزّل النتيجة قبل انتهاء الصلاحية.

ملاحظات مهمة

• لا تضع API Key في كود المتصفح أو حزمة تطبيق جوال أو مستودع عام.
• تُخصم النقاط الفعلية عند النجاح وتُحرر النقاط المحجوزة عند الفشل المؤكد. لا يمكن الإرسال عندما يقل الرصيد عن الحد المضبوط.