معلومات واجهة برمجة تطبيقات الموزع - مساعدة ChimeraTool

يمكنك استخدام فئة PHP الخاصة بنا للتواصل مع خوادم chimeratool.com.cn: نقل الاعتمادات، وإلغاء تحويلات الاعتمادات، وجمع المعلومات حول حسابك (على سبيل المثال رصيد الائتمان الخاص بك)، وإدراج التحويلات الخاصة بك وتحديد مستخدمي chimeratool.

تتواصل فئة PHP الخاصة بنا عبر بروتوكول HTTPS وتستخدم طريقة GET لاسترجاع البيانات بتنسيق JSON.

يمكنك تنزيل نداء PHP هنا .

رموز الخطأ والرسائل

يمكن أن تستجيب مكالمات واجهة برمجة التطبيقات برموز خطأ مختلفة، حتى تتمكن من تحديد الخطأ بسهولة.

أخطاء التوصيلات

أخطاء المصادقة

أخطاء النقل

قائمة الأخطاء

إلغاء الأخطاء

التحقق من أخطاء المستخدم

التحقق من أخطاء بطاقة ChimeraCard

التحقق من أخطاء تراخيص المستخدم

أخطاء ترخيص البيع

أخطاء تمديد الترخيص

أخطاء ترقية الترخيص

إلغاء أخطاء الترخيص

وظائف API

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

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

ChimeraApi::getTransferList($page = 1, $limit = 50)

يمكنك الاستعلام عن معاملاتك/إدراجها في قائمة بهذه الطريقة. يمكنك الحصول على معرفات المعاملات التي ترغب في إلغائها. يتم ترتيب القائمة الناتجة حسب التاريخ بترتيب تنازلي.

حدود:

• $page - صفحة مجموعة النتائج (الصفحة الأولى هي 1)
• $limit - عدد النتائج في صفحة واحدة (لا يمكن أن يكون أكبر من 200)

إنها مثل وظيفة الترقيم القياسية. إذا كان لديك 500 معاملة وتم ضبط الحد الأقصى على 50، فستعرض الصفحة الأولى النتائج من المعاملات من 1 إلى 50، وستعرض الصفحة الثانية المعاملات من 51 إلى 100.

يعود:

• النجاح - يشير إلى ما إذا كانت المكالمة ناجحة (منطقية)
• التحويلات - قائمة التحويلات الائتمانية (المصفوفة الترابطية)
  • id - معرف النقل (int)
  • التاريخ - تاريخ النقل (مصفوفة ارتباطية، كائن DateTime متسلسل)
  • من - اسم المستخدم الذي جاءت منه الاعتمادات (سلسلة)
  • إلى - اسم المستخدم الذي تم إرسال الاعتمادات إليه (سلسلة)
  • المبلغ - مبلغ الائتمان المحول (عشري)
  • تم إلغاؤه - يشير إلى أن المعاملات تم إلغاؤها (منطقي)

ChimeraApi::getInfo()

يقدم معلومات حول حسابك.

حدود: -

يعود:

• النجاح - يشير إلى ما إذا كانت المكالمة ناجحة (منطقية)
• creditBalance - رصيدك الائتماني الحالي
• transfersCount - عدد التحويلات الائتمانية الخاصة بك

ChimeraApi::transferCredit($userId, $amount)

تحويل رصيد '$amount' من حسابك إلى '$userId'.

حدود:

• $userId - معرف المستخدم الذي تريد إرسال الائتمان إليه
• $amount - عدد الاعتمادات التي تريد نقلها

يعود:

• النجاح - يشير إلى ما إذا كانت المكالمة ناجحة (منطقية)

• transferId - معرف تحويل الائتمان (عدد صحيح)

• الرسالة - رسالة نجاح يمكن قراءتها من قبل البشر

ChimeraApi::revokeTransfer($transferId)

إلغاء التحويل الذي تم تحديده بواسطة '$transferId'.

حدود:

• $transferId - معرف تحويل الائتمان الذي تريد إلغاؤه (الحصول عليه من transferCredit)

يعود:

• النجاح - يشير إلى ما إذا كانت المكالمة ناجحة (منطقية)
• الرسالة - رسالة نجاح يمكن قراءتها من قبل البشر

ChimeraApi::checkUser($username, $email)

يمكنك التحقق من هوية المستخدم باستخدام هذه الوظيفة، حيث تستجيب بمعرف المستخدم المحدد.

حدود:

• $username - اسم المستخدم

يعود:

• النجاح - يشير إلى ما إذا كانت المكالمة ناجحة (منطقية)
• userId - معرف المستخدم المحدد

ChimeraApi::checkChimeraCard($serialnumber)

يمكنك التحقق من بطاقة ChimeraCard باستخدام هذه الوظيفة.

حدود:

• $serialnumber - الرقم التسلسلي للبطاقة

يعود:

• النجاح - يشير إلى ما إذا كانت المكالمة ناجحة (منطقية)
• serialnumber - الرقم التسلسلي لبطاقة ChimeraCard (سلسلة)
• haslicence - يشير إلى ما إذا كانت بطاقة ChimeraCard تحتوي على ترخيص (منطقي)
• licensename - إذا كانت بطاقة ChimeraCard تحتوي على ترخيص، فسيكون اسم الترخيص (السلسلة) هنا، وإلا فسيكون null

ChimeraApi::checkUserLicences($username, $email)

التحقق من تراخيص المستخدم.

حدود:

• $username - اسم المستخدم

يعود:

• النجاح - يشير إلى ما إذا كانت المكالمة ناجحة (منطقية)
• userId - معرف المستخدم المحدد
• التراخيص - تراخيص المستخدم (مجموعة)

ChimeraApi::sellLicence($targetid, $targettype, $licencename)

بيع ترخيص.

حدود:

• $targetid - معرف الهدف (معرف المستخدم أو الرقم التسلسلي لبطاقة ChimeraCard)
• $targettype - إما 'user' أو 'chimeracard'
• $licencename - اسم الترخيص

يعود:

• النجاح - يشير إلى ما إذا كانت المكالمة ناجحة (منطقية)

• actionId - معرف إجراء الموزع (عدد صحيح)

ChimeraApi::extendLicence($userlicenceid)

تمديد الترخيص.

حدود:

• $userlicenceid - معرف ترخيص المستخدم

يعود:

• النجاح - يشير إلى ما إذا كانت المكالمة ناجحة (منطقية)

ChimeraApi::upgradeLicence($userlicenceid, $licencename = 'Pro')

ترقية الترخيص.

حدود:

• $userlicenceid - معرف ترخيص المستخدم
• $licencename - إما "Pro" أو "Premium"، الافتراضي هو "Pro" (اختياري)

يعود:

• النجاح - يشير إلى ما إذا كانت المكالمة ناجحة (منطقية)

ChimeraApi::التراخيص المتاحة

قائمة التراخيص المتاحة

حدود:

• -

يعود:

• التراخيص - التراخيص المتاحة (مجموعة)

ChimeraApi::buyLicencePrices($userId)

يحسب أسعار التراخيص للمستخدم

حدود:

• معرف المستخدم

يعود:

• التراخيص - التراخيص المتاحة (مجموعة)

ChimeraApi::getSoldLicenceList($page, $limit)

إرجاع قائمة التراخيص المباعة

حدود:

• $page - رقم الصفحة
• $limit - النتائج لكل صفحة

يعود:

• نجاح
• soldLicences - (مجموعة)
• الترقيم الصفحي - معلومات حول الترقيم الصفحي

ChimeraApi::revokeLicence($actionId)

إلغاء الترخيص المباع (إن أمكن)

حدود:

• $actionId - معرف الإجراء (يتم الحصول عليه من sellLicence وgetSoldLicenceList)

يعود:

• نجاح