API اینڈ پوائنٹس - API دستاویزات

بنیادی URL

:پیداوار https://api.usdtlowfee.com

عام روایات

یونٹس

• sun: 1 TRX = 1,000,000 sun (تمام قیمت کے فیلڈز sun استعمال کرتے ہیں)
• energyValue: انرجی یونٹس (int64 نمبر)
• durationHours: گھنٹے (int نمبر)

ڈیٹا کی اقسام

• ID فیلڈز: int64 نمبر (snowflake ID)
• قیمت فیلڈز: int64 نمبر (*Sun کے ساتھ ختم ہوتے ہیں جیسے: balanceSun، priceSun)
• وقت فیلڈز: ٹیکسٹ (ISO8601 UTC فارمیٹ جیسے: "2025-01-15T10:30:00Z")
• Boolean فیلڈز: true/false

ردعمل کی شکل

• کامیابی: { "data": {...}, "meta": {...} } (meta اختیاری)
• خرابی: { "error": { "code": "...", "message": "..." } }

اکاؤنٹ کا انتظام

والیٹ بیلنس اور صارف کی معلومات کی استفسار کریں

GET /v1/wallet/balance

بیلنس کی استفسار کریں

موجودہ والیٹ بیلنس کی استفسار کریں

:جواب کی مثال

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

GET /v1/users/me

صارف کی معلومات

موجودہ صارف کی بنیادی معلومات کی استفسار کریں

:جواب کی مثال

{
  "data": {
    "id": 123456,
    "email": "user@example.com",
    "emailVerified": true,
    "createdAt": "2025-01-01T00:00:00Z"
  }
}

آرڈر کا انتظام

انرجی آرڈرز بنائیں اور ان کی استفسار کریں

POST /v1/energy/orders

آرڈر بنائیں

مخصوص پتے کے لیے انرجی کرایہ کا آرڈر بنائیں (فی الوقت صرف manual قسم کی حمایت کرتا ہے)

:درخواست کے پیرامیٹرز

پیرامیٹر	قسم	ضروری	تفصیل
type	string	ہاں	آرڈر کی قسم، فی الوقت صرف "manual" کی حمایت کرتا ہے
data.tronAddress	string	ہاں	TRON پتہ جو انرجی وصول کرے گا (34 حروف، T سے شروع)
data.energyValue	int64	ہاں	انرجی کی مقدار (نمبر، کم از کم 32000، USDT منتقلی کے لیے 65000 تجویز کیا جاتا ہے)
data.durationHours	int	ہاں	کرایہ کی مدت (گھنٹوں میں، درست اقدار: 1، 24، 72، 168، 336، 720)

:درخواست کی مثال

{
  "type": "manual",
  "data": {
    "tronAddress": "TYour1Address2Here3...",
    "energyValue": 65000,
    "durationHours": 1
  }
}

:جواب کی مثال

{
  "data": {
    "id": 1234567890,
    "userId": 9876543210,
    "tronAddress": "TYour1Address2Here3...",
    "energyValue": 65000,
    "durationHours": 1,
    "priceSun": 3000000,
    "priceTrx": 3.0,
    "orderType": "manual",
    "status": "processing",
    "createdAt": "2025-01-15T10:30:00Z",
    "updatedAt": "2025-01-15T10:30:00Z",
    "statusUpdatedAt": "2025-01-15T10:30:00Z",
    "canTransitionTo": ["completed", "failed"]
  }
}

GET /v1/energy/orders/:id

آرڈر کی استفسار کریں

ID کے ذریعے آرڈر کی تفصیلات کی استفسار کریں

:جواب کی مثال

{
  "data": {
    "id": 1234567890,
    "userId": 9876543210,
    "tronAddress": "TYour1Address2Here3...",
    "energyValue": 65000,
    "durationHours": 1,
    "priceSun": 3000000,
    "priceTrx": 3.0,
    "orderType": "manual",
    "status": "completed",
    "txid": "abc123...",
    "createdAt": "2025-01-15T10:30:00Z",
    "completedAt": "2025-01-15T10:30:05Z",
    "updatedAt": "2025-01-15T10:30:05Z",
    "statusUpdatedAt": "2025-01-15T10:30:05Z",
    "canTransitionTo": []
  }
}

GET /v1/energy/orders

آرڈرز کی فہرست

آرڈرز کی فہرست کی استفسار کریں (پیجینیشن اور فلٹرنگ کی حمایت کرتا ہے)

:درخواست کے پیرامیٹرز

پیرامیٹر	قسم	ضروری	تفصیل
offset	number	نہیں	شروعاتی نقطہ، ڈیفالٹ 0
limit	number	نہیں	فی صفحہ اشیاء کی تعداد، ڈیفالٹ 20، زیادہ سے زیادہ 100
status	string	نہیں	آرڈر کی حیثیت کے مطابق فلٹر کریں: processing، completed، failed

:جواب کی مثال

{
  "data": {
    "orders": [
      {
        "id": 1234567890,
        "userId": 9876543210,
        "tronAddress": "TYour1...",
        "energyValue": 65000,
        "durationHours": 1,
        "priceSun": 3000000,
        "priceTrx": 3.0,
        "orderType": "manual",
        "status": "completed",
        "createdAt": "2025-01-15T10:30:00Z",
        "updatedAt": "2025-01-15T10:30:05Z",
        "statusUpdatedAt": "2025-01-15T10:30:05Z",
        "canTransitionTo": []
      }
    ],
    "total": 100,
    "offset": 0,
    "limit": 20
  }
}

پتے کا انتظام

اکثر استعمال ہونے والے پتوں کا انتظام کریں

POST /v1/addresses

پتہ شامل کریں

ایک نیا پتہ محفوظ کریں

:درخواست کی مثال

{
  "tronAddress": "TYour1Address2Here3...",
  "label": "مرکزی والیٹ",
  "isDefault": false
}

:جواب کی مثال

{
  "data": {
    "id": 1,
    "tronAddress": "TYour1Address2Here3...",
    "label": "مرکزی والیٹ",
    "isDefault": false,
    "usageCount": 0,
    "createdAt": "2025-01-01T00:00:00Z"
  }
}

GET /v1/addresses

پتوں کی فہرست

محفوظ شدہ پتوں کی فہرست حاصل کریں

:جواب کی مثال

{
  "data": {
    "addresses": [
      {
        "id": 1,
        "tronAddress": "TYour1Address2Here3...",
        "label": "مرکزی والیٹ",
        "isDefault": true,
        "usageCount": 5,
        "lastUsedAt": "2025-01-15T10:30:00Z",
        "createdAt": "2025-01-01T00:00:00Z"
      }
    ],
    "total": 1
  }
}

GET /v1/addresses/:id

پتے کی تفصیلات

پتے کی معلومات کی استفسار کریں

:جواب کی مثال

{
  "data": {
    "id": 1,
    "tronAddress": "TYour1Address2Here3...",
    "label": "مرکزی والیٹ",
    "isDefault": true,
    "usageCount": 5,
    "lastUsedAt": "2025-01-15T10:30:00Z",
    "createdAt": "2025-01-01T00:00:00Z"
  }
}

PUT /v1/addresses/:id/label

پتے کا لیبل اپ ڈیٹ کریں

پتے کا لیبل تبدیل کریں

:درخواست کی مثال

{
  "label": "نیا لیبل"
}

:جواب کی مثال

{
  "data": {
    "id": 1,
    "tronAddress": "TYour1Address2Here3...",
    "label": "نیا لیبل",
    "isDefault": false,
    "usageCount": 3,
    "lastUsedAt": "2025-01-15T10:30:00Z",
    "createdAt": "2025-01-01T00:00:00Z"
  }
}

PUT /v1/addresses/:id/default

ڈیفالٹ پتے کے طور پر سیٹ کریں

مخصوص پتے کو ڈیفالٹ وصول کنندہ پتے کے طور پر سیٹ کریں

:جواب کی مثال

// HTTP 204 No Content
// کوئی ردعمل کا مواد نہیں

کامیابی پر مواد کے بغیر 204 حیثیت لوٹاتا ہے

DELETE /v1/addresses/:id

پتہ حذف کریں

محفوظ شدہ پتہ حذف کریں