البدء السريع

أكمل أول طلب API خاص بك في 10 دقائق

1. إنشاء مفتاح API

إنشاء مفتاح API الأول من لوحة التحكم

انتقل إلى إعدادات الحساب → قسم مفاتيح API
انقر على زر "إنشاء مفتاح API"
أدخل اسمًا للمفتاح (مثال: Production)
انسخ واحفظ مفتاح API الذي تم إنشاؤه (سيُعرض مرة واحدة فقط)

⚠️ سيُعرض مفتاح API مرة واحدة فقط عند الإنشاء. يُرجى الاحتفاظ به بشكل آمن

2. إرسال الطلب الأول

اختبار اتصال API باستخدام curl

الاستعلام عن رصيد المحفظة

BASE_URL=...   # النطاق الفعلي لبيئة الإنتاج
API_KEY=ak_live_...

curl -H "Authorization: ApiKey $API_KEY" "$BASE_URL/v1/wallet/balance"

استجابة نموذجية

{
  "data": {
    "balanceSun": 1000000,
    "frozenSun": 0,
    "totalSun": 1000000
  }
}

// لمزيد من المعلومات حول الوحدات وأنواع البيانات، يُرجى الاطلاع على <a href="/ar/docs/endpoints" class="text-blue-600 hover:underline">نقاط نهاية API</a>

3. إنشاء طلب طاقة

تأجير طاقة لعنوان محدد

إنشاء طلب

curl -X POST "$BASE_URL/v1/energy/orders" \
  -H "Authorization: ApiKey $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "manual",
    "data": {
      "tronAddress": "TYour1Address2Here3...",
      "energyValue": 65000,
      "durationHours": 1
    }
  }'

// tronAddress: 34 حرفًا، يبدأ بـ T
// durationHours: 1, 24, 72, 168, 336, 720 (ساعات)

استجابة نموذجية

{
  "data": {
    "id": 1234567890,
    "status": "processing",
    "priceSun": 3000000,
    "createdAt": "2025-01-15T10:30:00Z"
  }
}

4. التحقق من حالة الطلب

التحقق مما إذا كان الطلب قد اكتمل

الاستعلام عن الطلب

curl -H "Authorization: ApiKey $API_KEY" "$BASE_URL/v1/energy/orders/1234567890"

استجابة نموذجية

{
  "data": {
    "id": 1234567890,
    "status": "completed",
    "txid": "abc123...",
    "completedAt": "2025-01-15T10:30:05Z"
  }
}

الخطوات التالية

تعلم المزيد عن المصادقة →

عرض قائمة جميع نقاط النهاية →

تعلم كيفية معالجة الأخطاء →