احتفظ بالمصادقة على الخادم
أنشئ حسابك وتحقق منه، ثم استخدم مفتاح API نشطاً من لوحة التحكم. احفظ المفتاح السري في بيئة الخادم، وليس في كود المتصفح أو المستودعات العامة أو الروابط. يظهر المفتاح كاملاً عند إنشائه فقط. وإذا انكشف، فاحذفه وأنشئ بديلاً.
استدعِ GET /api/v1/lookup/{number} من الخادم باستخدام Authorization: Bearer أو x-api-key، وليس كليهما. راجع توثيق API لمعرفة الطلب الدقيق وحقول الاستجابة وأمثلة الكود.
أنشئ إجراءات أعمال قابلة للمراجعة
عند تسجيل الموردين، استرجع السجل وقارن الرقم والاسم القانوني المقدمين. وعند تسجيل عملاء المنشآت، اعرض بيانات المنشأة المتاحة للتأكيد. أحِل الأسماء الملتبسة والاختلافات للمراجعة بدلاً من رفض الطلب بصمت.
احفظ فترة البيانات المعادة مع أي نتيجة تحتفظ بها. تستخدم الواجهة إصدار السجل المنشور النشط؛ وعند تفعيل إصدار أحدث يتغير مصدر الطلبات اللاحقة دون الحاجة إلى تغيير نقطة الاتصال.
عالج الأخطاء دون فقدان مدخلات المستخدم
ميّز بين عدم العثور على سجل وبين المدخل غير الصحيح أو خطأ المصادقة أو حد الطلبات أو تعطل الخدمة المؤقت. احتفظ ببيانات النموذج للتصحيح أو إعادة المحاولة. التزم بقيمة Retry-After إن وُجدت، وتجنب تكرار المحاولات تلقائياً ببيانات اعتماد غير صحيحة.
تشترك طلبات الحساب في حد قدره 60 طلباً في الدقيقة وسقف تراكمي يبلغ 1,000,000 طلب مقبول عبر المفاتيح والجلسات المخوّلة. ولا يُعاد ضبط السقف عند حذف مفتاح أو تجديد الوصول. راجع سياسة الاستخدام العادل قبل تصميم إجراءات كثيفة الطلبات.
جرّب الأدوات واقرأ التوثيق
سعودي سي آر برو خدمة مستقلة وليست تابعة لوزارة التجارة أو لأي جهة حكومية. للحصول على معلومات رسمية حالية أو مستخرج معتمد، استخدم خدمة الاستعلام لدى وزارة التجارة.