من أجل تعزيز كفاءة العمليات التجارية وقدرات الإدارة المنهجية، أطلقت Gate رسميًا خدمة واجهة برمجة التطبيقات (P2P API).
تُعد P2P API خدمة واجهة رسمية مُقدمة للتجار المعتمدين في قسم التداول من شخص لشخص (P2P). تتيح هذه الخدمة للتجار ربط أنظمتهم الداخلية بشكل آمن عبر واجهات برمجة تطبيقات موحدة، وتدعم وظائف مثل نشر الإعلانات وإدارتها، الاستعلام عن الطلبات ومعالجتها، الإفراج التلقائي وإلغاء أوامر العملات الرقمية، التفاعل عبر الرسائل الفورية، والاستعلام عن معلومات الحساب.
من خلال التكامل مع P2P API، يمكن للتجار تحقيق ما يلي:
- إدارة الإعلانات بشكل تلقائي وتعديل الأسعار ديناميكيًا
- الاستعلام عن الطلبات ومعالجتها بكفاءة وفي الوقت الفعلي
- تقليل التكاليف التشغيلية اليدوية وتقليص المخاطر التشغيلية
- إنشاء نظام تشغيلي آلي يعمل على مدار الساعة طوال أيام الأسبوع
- دعم تنفيذ استراتيجيات صناعة السوق المتعددة وتوسيع نطاق العمليات
إطلاق P2P API سيعزز من احترافية وقابلية التوسع في منظومة التجار على المنصة، مما يساعد التجار ذوي الجودة العالية على تحسين كفاءة المعاملات وتعزيز القدرة التنافسية في السوق.
أولاً: المستخدمون المؤهلون
تتوفر خدمة P2P API للمستخدمين التاليين:
- تجار Gate الذين أكملوا عملية التحقق كتاجر P2P واجتازوا مراجعة المنصة (بما في ذلك التجار المعتمدين، تجار Blue V، تجار التاج، وغيرهم)
- فرق التجار أو شركات دمج الأنظمة التي تمتلك قدرات تطوير تقني
- فرق صناعة السوق الاحترافية التي تحتاج إلى تداول آلي أو إدارة إعلانات جماعية أو تنفيذ استراتيجيات متعددة
ملاحظة: الحسابات التي لم تُكمل عملية التحقق كتاجر غير مؤهلة لاستخدام ميزات P2P API.
ثانيًا: كيفية استخدام P2P API
التحقق كتاجر
- سجّل الدخول إلى حسابك على Gate وانتقل إلى صفحة توظيف أو إدارة تجار P2P للتقديم كتاجر تداول عملات نقدية، مثل تاجر عادي، تاجر Blue V، أو تاجر التاج، إلخ.
- بعد الموافقة على طلب التاجر، سيتم تفعيل صلاحيات التاجر.
إنشاء مفتاح API
- انتقل إلى صفحة إدارة مفاتيح API (مفاتيح API V4) وأنشئ مفتاح API (تأكد من تفعيل صلاحيات P2P API).
- يتكون مفتاح API من
Access KeyوSecret Key. يرجى حفظهما بشكل آمن وعدم مشاركتهما مع أي طرف.
ملاحظة: يرجى الحفاظ على سرية مفتاح Secret Key لمنع الوصول غير المصرح به.
استدعاء واجهة API
- وقّع الطلبات وفقًا لقواعد التوقيع الرسمية
- استخدم طلبات HTTPS POST لاستدعاء الواجهة
- راجع الوثائق الرسمية لواجهة API للحصول على كود المثال الخاص بـ SDK
ثالثًا: وظائف P2P API
توفر واجهة P2P Merchant API من Gate إمكانيات إدارة شاملة عبر الوحدات الأساسية مثل الحسابات، الإعلانات، الطلبات، والدردشة.
| الوحدة | API | الميزة |
|---|---|---|
| إدارة الحسابات | POST /p2p/merchant/account/get_user_info | استرجاع معلومات التاجر الأساسية |
| POST /p2p/merchant/account/get_myself_payment | استرجاع قائمة طرق الدفع المدعومة من التاجر | |
| POST /p2p/merchant/account/get_counterparty_user_info | استرجاع معلومات مستخدم الطرف المقابل في التداول | |
| إدارة الإعلانات | POST /p2p/merchant/books/place_biz_push_order | نشر الإعلانات |
| POST /p2p/merchant/books/ads_update_status | تحديث حالة الإعلان (تشغيل/إيقاف) | |
| POST /p2p/merchant/books/ads_detail | استرجاع تفاصيل الإعلان | |
| POST /p2p/merchant/books/my_ads_list | استرجاع قائمة إعلانات التاجر الحالية | |
| POST /p2p/merchant/books/ads_list | استرجاع قائمة إعلانات السوق | |
| إدارة الطلبات | POST /p2p/merchant/transaction/get_pending_transaction_list | عرض الطلبات الجارية |
| POST /p2p/merchant/transaction/get_completed_transaction_list | عرض الطلبات السابقة | |
| POST /p2p/merchant/transaction/get_transaction_details | عرض تفاصيل الطلب | |
| POST /p2p/merchant/transaction/confirm-payment | تأكيد التاجر استلام الدفعة | |
| POST /p2p/merchant/transaction/confirm-receipt | تأكيد التاجر الإفراج عن العملات الرقمية | |
| POST /p2p/merchant/transaction/cancel | إلغاء الطلب بواسطة التاجر | |
| إدارة الدردشة | POST /p2p/merchant/chat/get_chats_list | استرجاع قائمة الدردشات / سجل المحادثات |
| POST /p2p/merchant/chat/send_chat_message | إرسال رسائل الدردشة | |
| POST /p2p/merchant/chat/upload_chat_file | رفع ملفات أو مرفقات الدردشة |
رابعًا: الدعم والملاحظات
إذا كنت بحاجة إلى دعم إضافي بخصوص P2P API، يرجى التواصل مع فريقنا التقني عبر مجموعة Telegram الرسمية لـ P2P API. سيكون مسؤولو API وأعضاء المجتمع سعداء بمساعدتك والإجابة على أي استفسارات.
