مقدمة
واجهة برمجة تطبيقات p3p هي واجهة HTTP/JSON عامة لتبادل p3p عبر السلاسل. تتيح لك:
- جلب السلاسل والرموز المدعومة وأسعار السوق الحية
- الحصول على عروض أسعار وتنفيذ المبادلات عبر مصادر سيولة مجمعة متعددة
- قبول المدفوعات كتاجر عبر الفواتير، مع تسوية الأموال مباشرة إلى محفظتك
p3p غير حافظة: لا تحتفظ واجهة البرمجة بأموال المستخدمين لأكثر من بضع ثوانٍ اللازمة لتوجيه المبادلة، ولا تحتاج أبداً إلى مشاركة المفاتيح الخاصة أو إجراء KYC.
عنوان URL الأساسي
https://api.p3p.xyzنموذج المصادقة
يحتوي p3p على نوعين متميزين من المستخدمين بمتطلبات مصادقة مختلفة.
المطورون
يجب على المطورين الذين يبنون تطبيقات تنفذ المبادلات برمجياً (جلب السلاسل والرموز والأسعار وإنشاء التبادلات) تضمين رأس api-key صالح في كل طلب.
http
api-key: your_api_key_here| حالة الاستخدام | ما تحتاجه |
|---|---|
| جلب السلاسل والرموز والأسعار | رأس api-key |
| الحصول على عرض سعر للمبادلة | رأس api-key |
| تنفيذ مبادلة | رأس api-key |
| كسب حصة من الإيرادات على المبادلات | رأس api-key + تعيين opts.partner_id لمعرف الشريك الخاص بك |
للحصول على مفتاح API، تواصل معنا على تيليجرام.
التجار
يقبل التجار مدفوعات العملات الرقمية عبر الفواتير. لا حاجة لمفتاح API — عنوان محفظتك هو هويتك.
| حالة الاستخدام | ما تحتاجه |
|---|---|
| إنشاء فاتورة | عنوان محفظتك كـ wallet_merchant في الجسم |
| عرض فواتيرك / أرباحك | عنوان محفظتك في عنوان URL لنقاط النهاية الخاصة بالشريك |
لا تسجيل. لا رموز. فقط استخدم محفظتك. راجع دليل التجار.
تنسيق الاستجابة
كل نقطة نهاية تعيد JSON.
النجاح:
json
{ "id": "ex_...", "status": "waiting", "...": "..." }الخطأ:
json
{ "error": "wallet_to_invalid", "message": "wallet_to has invalid address: ..." }حدود المعدل
إذا تلقيت HTTP 429، فأبطئ أو تواصل معنا لرفع الحد لمشروعك.