الانتقال إلى المحتوى الرئيسي
ستقدم هذه الوثيقة شرحًا عن واجهة برمجة التطبيقات لاستعلام معلومات بطاقة البنك الأساسية، والتي يمكن استخدامها لاستعلام معلومات بطاقة البنك الأساسية.

​
عملية التقديم

لاستخدام واجهة برمجة التطبيقات، يجب أولاً الذهاب إلى واجهة برمجة التطبيقات لاستعلام معلومات بطاقة البنك الأساسية وتقديم طلب الخدمة المناسبة، بعد الدخول إلى الصفحة، انقر على زر “Acquire”، كما هو موضح في الصورة: إذا لم تكن قد قمت بتسجيل الدخول أو التسجيل بعد، سيتم تحويلك تلقائيًا إلى صفحة تسجيل الدخول لدعوتك للتسجيل وتسجيل الدخول، وبعد تسجيل الدخول، سيتم العودة تلقائيًا إلى الصفحة الحالية. عند التقديم لأول مرة، سيكون هناك حد مجاني متاح، يمكنك استخدام واجهة برمجة التطبيقات مجانًا.

​
الاستخدام الأساسي

أولاً، يجب أن نفهم طريقة الاستخدام الأساسية، وهي إدخال رقم بطاقة البنك، للحصول على نتيجة التحقق بعد المعالجة، يجب أولاً تمرير حقل bank_card ببساطة، ثم يمكننا ملء المحتوى المقابل على الواجهة، كما هو موضح في الصورة:

يمكنك أن ترى هنا أننا قمنا بتعيين رؤوس الطلب، بما في ذلك:
  • accept: نوع الاستجابة التي ترغب في تلقيها، هنا يتم ملؤها بـ application/json، أي بتنسيق JSON.
  • authorization: مفتاح استدعاء واجهة برمجة التطبيقات، بعد التقديم يمكنك اختيارها مباشرة من القائمة المنسدلة.
بالإضافة إلى ذلك، تم تعيين جسم الطلب، بما في ذلك:
  • bank_card: رقم بطاقة البنك.
  • encryption: اختياري، معلمة تشفير الحقول الحساسة (إذا كان هناك حاجة لإرسال نص مشفر).
بعد الاختيار، يمكنك أن تلاحظ أن الجانب الأيمن قد أنشأ أيضًا كودًا مطابقًا، كما هو موضح في الصورة:

انقر على زر “Try” لإجراء الاختبار، كما هو موضح في الصورة أعلاه، هنا حصلنا على النتيجة التالية: 
{
  "result": "0",
  "description": "استعلام ناجح",
  "account_bank": "بنك الصناعة والتجارة",
  "account_type": 1
}
تتضمن النتيجة العائدة عدة حقول، كما هو موضح أدناه:
  • result، رمز نتيجة التحقق، حالة الرسوم كما يلي.
    • رموز نتائج الرسوم:
      • 0: استعلام ناجح
      • -1: لم يتم العثور على معلومات
    • رموز النتائج غير الرسومية:
      • -2: خدمة مركز التحقق مشغولة
      • -3: بطاقة البنك غير موجودة
  • description، وصف نتيجة العمل.
  • account_bank، البنك الذي تم فتح الحساب فيه.
  • account_type، نوع البطاقة: 1. بطاقة خصم؛ 2. بطاقة ائتمان؛ 3. بطاقة مسبقة الدفع؛ 4. بطاقة ائتمان مؤقتة.
يمكنك أن ترى أن معلومات بطاقة البنك الأساسية قد تم استعلامها. بالإضافة إلى ذلك، إذا كنت ترغب في إنشاء كود التكامل المقابل، يمكنك نسخه مباشرة، على سبيل المثال، كود CURL كما يلي: 
curl -X POST 'https://api.acedata.cloud/identity/bankcard/check-1e' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "bank_card": "****"
}'
كود التكامل بلغة Python كما يلي: 
import requests

url = "https://api.acedata.cloud/identity/bankcard/check-1e"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "bank_card": "****"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

​
معالجة الأخطاء

عند استدعاء واجهة برمجة التطبيقات، إذا واجهت خطأ، ستقوم واجهة برمجة التطبيقات بإرجاع رمز الخطأ والمعلومات المناسبة. على سبيل المثال:
  • 400 token_mismatched: طلب غير صحيح، ربما بسبب معلمات مفقودة أو غير صالحة.
  • 400 api_not_implemented: طلب غير صحيح، ربما بسبب معلمات مفقودة أو غير صالحة.
  • 401 invalid_token: غير مصرح به، رمز تفويض غير صالح أو مفقود.
  • 429 too_many_requests: عدد كبير جدًا من الطلبات، لقد تجاوزت الحد الأقصى لمعدل الطلبات.
  • 500 api_error: خطأ داخلي في الخادم، حدث خطأ ما على الخادم.

​
مثال على استجابة الخطأ

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "فشل في الاسترجاع"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​
الخاتمة

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