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

पता हटाएं

सहेजा गया पता हटाएं