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

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

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

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

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

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

انقر على زر “Try” لإجراء الاختبار، كما هو موضح في الصورة أعلاه، هنا حصلنا على النتيجة التالية: 
{
  "result": "0",
  "description": "认证通过"
}
تتضمن النتيجة العائدة عدة حقول، كما هو موضح أدناه:
  • result، رمز نتيجة التحقق، حالة الرسوم كما يلي.
    • رموز نتائج الرسوم:
      • 0: تم التحقق بنجاح
      • -1: لم يتم التحقق
      • -4: معلومات حامل البطاقة غير صحيحة
      • -5: لم يتم تفعيل الدفع بدون بطاقة
      • -6: تم استرداد هذه البطاقة
      • -7: رقم بطاقة غير صالح
      • -8: لا توجد جهة إصدار مطابقة لهذه البطاقة
      • -9: لم يتم تهيئة هذه البطاقة أو بطاقة نائمة
      • -10: بطاقة غش، تم ابتلاع البطاقة
      • -11: تم الإبلاغ عن فقدان هذه البطاقة
      • -12: انتهت صلاحية هذه البطاقة
      • -13: بطاقة مقيدة
      • -14: تجاوز عدد محاولات إدخال كلمة المرور الحد المسموح به
      • -15: جهة إصدار البطاقة لا تدعم هذه المعاملة
    • رموز نتائج غير الرسوم:
      • -2: فشل التحقق من الاسم
      • -3: رقم بطاقة البنك غير صحيح
      • -16: مركز التحقق مشغول
      • -17: تجاوز عدد مرات التحقق، يرجى المحاولة مرة أخرى في اليوم التالي
  • description، وصف نتيجة العمل.
يمكنك أن ترى أن رقم بطاقة البنك، الاسم، رقم الهوية، ورقم الهاتف المحمول المرتبط بالحساب تتمتع بصحة وتوافق. بالإضافة إلى ذلك، إذا كنت ترغب في توليد كود التكامل المقابل، يمكنك نسخه مباشرة، على سبيل المثال، كود CURL كما يلي: 
curl -X POST 'https://api.acedata.cloud/identity/bankcard/check-4e' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "name": "***",
  "phone": "***",
  "id_card": "***",
  "bank_card": "***"
}'
كود التكامل بلغة Python كما يلي: 
import requests

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

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

payload = {
    "name": "胡印福",
    "phone": "***",
    "id_card": "***",
    "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": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​
الخاتمة

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