ربط API والتكامل — نجاز بلاس

ربط REST API

يوفر نجاز كارد واجهة REST API لتسهيل ربط المتاجر والمواقع والتطبيقات والبوتات بخدمات الشحن الرقمية المتاحة. تعتمد الواجهة على استجابات JSON لتسهيل التعامل مع البيانات داخل الأنظمة البرمجية.

لماذا تستخدم API نجاز كارد؟

ربط المتاجر

اربط متجرك الإلكتروني بخدمات نجاز كارد لتنفيذ عمليات الشحن بشكل آلي.

تنفيذ آلي

أتمتة عمليات الشحن وتقليل الحاجة إلى التدخل اليدوي في تنفيذ الطلبات.

متابعة الطلبات

إمكانية إرسال الطلبات والاستعلام عن حالتها من خلال نظامك.

الاستعلام عن الرصيد

يمكن للنظام الاستعلام عن رصيد الحساب من خلال واجهة API حسب البيانات المتاحة.

البوتات

مناسب لبوتات البيع وخدمة العملاء والأنظمة الآلية.

أنظمة الأتمتة

إمكانية دمج خدمات الشحن داخل الأنظمة واللوحات البرمجية المختلفة.

واجهة REST موحّدة

تكامل بسيط ومرن

يمكن استخدام API من خلال لغات برمجية متعددة مثل PHP وPython وNode.js وC# وJava وغيرها. كما يمكن دمج الواجهة مع المواقع والتطبيقات والمتاجر والبوتات.

REST / JSON API

{
    "format": "json",
    "style": "rest"
}

كيف أربط نظامي؟

1

إنشاء حساب

أنشئ حسابًا في نجاز كارد واستكمل بيانات الحساب المطلوبة.

2

تفعيل الربط

تواصل مع الدعم الفني لمعرفة متطلبات تفعيل خدمة API.

3

بيانات API

احصل على بيانات الربط المطلوبة وقم بإضافتها إلى إعدادات نظامك.

4

بدء الاستخدام

بعد إعداد النظام وتغذية الرصيد، ابدأ بإرسال الطلبات والاستعلام عنها.

تقييد IP

حماية الاتصال

لأسباب أمنية، قد يتم اعتماد عناوين IP محددة للاتصال بخدمة API حسب إعدادات الربط. في حال تطلب نظامك إضافة عنوان IP محدد، تواصل مع الدعم الفني لتزويدهم بعنوان خادمك.

حماية بيانات API

حافظ على سرية بيانات الربط

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

البوتات والأنظمة الآلية

بوتات البيع وخدمة العملاء

يمكن ربط البوت بخدمات نجاز كارد لاستقبال طلب العميل ثم إنشاء عملية الشحن والاستعلام عن حالة الطلب بشكل آلي.

الأتمتة

يمكن استخدام API داخل الأنظمة الآلية التي تحتاج إلى تنفيذ عمليات الشحن ومتابعة الطلبات دون تدخل يدوي متكرر.

أمثلة على الاستخدام

المتاجر الإلكترونية

ربط متجر شحن الألعاب والبطاقات بخدمات نجاز كارد.

تطبيقات الهواتف

إضافة خدمات الشحن إلى تطبيقات Android أو الأنظمة الأخرى.

المواقع واللوحات

إنشاء لوحة تحكم أو نظام داخلي يعتمد على خدمات API.

نقاط البيع POS

دمج خدمات الشحن داخل أنظمة البيع ونقاط الخدمة.

منصات المحادثة

استخدام API داخل بوتات وأنظمة المحادثة وخدمة العملاء.

CRM و ERP

دمج عمليات الشحن داخل أنظمة إدارة العملاء والموارد.

التحقق من أن الربط يعمل

اختبار الاتصال

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

الدعم الفني

مساعدة في الربط

فريق الدعم الفني في نجاز كارد يساعدك في استفسارات الربط والتكامل والمشاكل المتعلقة بالخدمة.

عند حدوث خطأ

عند التواصل مع الدعم، يفضل إرسال رسالة الخطأ أو استجابة API التي تظهر في النظام لتسهيل معالجة المشكلة.

جاهز لبدء الربط؟

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

تواصل مع الدعم

دليل المطوّرين — REST API