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

معلومات واجهة برمجة تطبيقات الموزع

هذه الوثیقة تمّ إنشاؤها بتأريخ: ١٤‏/٠٩‏/٢٠١٦ ٢:٠٣:٢٥ م,، وجرى تعديلها بتأريخ: ٢٤‏/٠٣‏/٢٠٢٤ ١١:٢٢:٥٩ ص.

يمكن لموزعي الائتمان ربط متاجرهم الإلكترونية بموقع chimeratool.cn بسهولة شديدة عبر واجهة Reseller API.

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

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

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

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

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

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

000

تعذر الاتصال بواجهة برمجة التطبيقات (API).

001

لا توجد استجابة من خادم API

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

100

فشل تسجيل الدخول بسبب عدم وجود اسم مستخدم أو مفتاح واجهة برمجة التطبيقات

101

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

102

المستخدم غير نشط حاليا

103

المستخدم مقفل (محظور)

104

لدى المستخدم رسالة بائع مهمة غير مقروءة. يمكن قراءته على https://chimeratool.cn/reseller/ . (يجب تسجيل الدخول قبل فتح الرابط) بعد قراءته وقبوله، ستعمل واجهة برمجة التطبيقات (API) مرة أخرى.

105

المستخدم غير مؤهل للحصول على حالة الموزع

أخطاء النقل

400

لم يتم تعيين معلمة "معرف المستخدم".

401

لم يتم تعيين المعلمة "المبلغ".

402

قيمة "المبلغ" ليست رقمية

403

يجب أن تكون قيمة "المبلغ" 1.0 أو أكبر

404

ليس لديك ما يكفي من الاعتمادات.

405

لا يمكن العثور على المستخدم المحدد بواسطة "معرف المستخدم" المحدد

406

لا يمكن أن تنتقل إلى نفسك

407

حدث استثناء أثناء العملية. (تواصل مع فريق الدعم على الفور)

408

الحد الأدنى للمبلغ القابل للتحويل إلى الموزع هو 20000 نقطة

409

الحد الأقصى للمبلغ القابل للتحويل هو 18000 نقطة

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

200

لا يمكن أن تكون قيمة "الحد" أكبر من 200

201

يجب أن يكون رقم "الصفحة" رقمًا موجبًا

202

يجب أن يكون رقم "الحد" رقمًا موجبًا

إبطال الأخطاء

300

يجب عليك تعيين المعلمة "transferId".

301

لا يمكن العثور على سجل النقل بالمعرف المحدد

302

لا يمكن إلغاء عملية النقل لأنها مر عليها أكثر من يوم واحد

303

ليس لدى المستخدم أرصدة كافية للإلغاء منها

304

تم إلغاء النقل بالفعل

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

500

لا يمكن العثور على المستخدم بالمعلمات المحددة

501

لم يتم إعطاء المعلمة "المستخدم".

502

الأخطاء المتعلقة بإذن المستخدم

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

600

معلمة "الرقم التسلسلي" مفقودة

601

لم يتم العثور على بطاقة ChimeraCard

602

خطأ في حالة ChimeraCard

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

700

معلمة "المستخدم" مفقودة

701

لم يتم العثور على المستخدم

702

خطأ غير معروف

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

801

المعلمة "targetid" مفقودة

802

المعلمة "targettype" مفقودة

803

المعلمة "licencename" مفقودة

804

تعذر العثور على الترخيص

805

خطأ في نوع الهدف

806

خطأ في التحقق من الهدف

807

لا يكفي الائتمان

808

تعذر العثور على المستخدم/بطاقة ChimeraCard

809يجب أن يكون "targetid" عددًا صحيحًا

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

901

المعلمة "userlicenceid" مفقودة

902

تعذر العثور على الترخيص

903

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

904

الترخيص غير قابل للتمديد

905

لا يكفي الائتمان

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

1001

المعلمة "userlicenceid" مفقودة

1002

تعذر العثور على الترخيص

1003

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

1004

الترخيص غير قابل للترقية

1005

المعلمة 'licencename' غير صالحة

1006

لا يكفي الائتمان

1007

نفس "اسم الترخيص" مثل ترخيص المستخدم

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

1100

معرف الإجراء غير صالح

1101

لم يتم العثور على العمل

1102

لا يمكن إلغاء الترخيص لأن عملية النقل مضى عليها أكثر من يوم واحد

1104

نوع الإجراء ليس "بيع الترخيص"

1105

تم إبطال الإجراء بالفعل

1107

خطأ غير معروف

 

وظائف واجهة برمجة التطبيقات

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

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

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

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

حدود:

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

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

يعود:

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

ChimeraApi::getInfo()

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

حدود: -

يعود:

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

ChimeraApi::transferCredit($userId, $amount)

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

حدود:

  • $userId - معرف المستخدم الذي تريد إرسال الرصيد إليه
  • $amount - عدد الاعتمادات التي تريد تحويلها

يعود:

  • النجاح - يشير إلى ما إذا كانت المكالمة ناجحة (منطقية)
  • TransferId - معرف تحويل الرصيد (عدد صحيح)
  • message - رسالة نجاح يمكن قراءتها من قبل الإنسان

ChimeraApi::revocTransfer($transferId)

قم بإلغاء النقل المحدد بواسطة "$transferId".

حدود:

  • $transferId - معرف تحويل الرصيد الذي تريد إبطاله (احصل عليه من TransferCredit)

يعود:

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

ChimeraApi::checkUser($اسم المستخدم، $email)

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

حدود:

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

يعود:

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

ChimeraApi::checkChimeraCard(الرقم التسلسلي $)

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

حدود:

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

يعود:

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

ChimeraApi::checkUserLicences($اسم المستخدم، $email)

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

حدود:

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

يعود:

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

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

بيع ترخيص.

حدود:

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

يعود:

  • النجاح - يشير إلى ما إذا كانت المكالمة ناجحة (منطقية)
  • actionId - معرف إجراء البائع (عدد صحيح)

ChimeraApi::extendLicence($userlicenceid)

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

حدود:

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

يعود:

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

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

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

حدود:

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

يعود:

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

ChimeraApi::availableLicences()

يسرد التراخيص المتاحة

حدود:

  • -

يعود:

  • التراخيص - التراخيص المتاحة (صفيف)

ChimeraApi::buyLicencePrices($userId)

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

حدود:

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

يعود:

  • التراخيص - التراخيص المتاحة (صفيف)

ChimeraApi::getSoldLicenceList($page, $limit)

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

حدود:

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

يعود:

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

ChimeraApi::revocLicence($actionId)

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

حدود:

  • $actionId - معرف الإجراء (الحصول على من SellLicence وgetSoldLicenceList)

يعود:

  • نجاح

Martview forum

Martview is not our official forum but it can bring help to all our customers, since the questions asked are answered by professionally relevant users and administrators there.

Open forum

Test Points Library

A continuously updated collection of Test Point photos, PCB Diagrams and Blueprints to help everyone easily find the test point pins on smartphone motherboards - all at one place!

Open Test point library

منتدى GSM Hosting

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

إذهب إلى المنتدى