Mga API Endpoint - Dokumentasyon ng API

Base URL

Produksyon: https://api.usdtlowfee.com

Mga Karaniwang Konbensyon

Mga Yunit

• sun: 1 TRX = 1,000,000 sun (lahat ng price fields ay gumagamit ng sun)
• energyValue: mga yunit ng energy (int64 numero)
• durationHours: oras (int numero)

Mga Uri ng Data

• ID fields: int64 numero (snowflake ID)
• Price fields: int64 numero (nagtatapos sa *Sun tulad ng: balanceSun, priceSun)
• Time fields: teksto (ISO8601 UTC format tulad ng: "2025-01-15T10:30:00Z")
• Boolean fields: true/false

Format ng Tugon

• Tagumpay: { "data": {...}, "meta": {...} } (meta ay opsyonal)
• Error: { "error": { "code": "...", "message": "..." } }

Pamamahala ng Account

Mag-query ng balanse ng wallet at impormasyon ng user

GET /v1/wallet/balance

Mag-query ng Balanse

Mag-query ng kasalukuyang balanse ng wallet

Halimbawa ng tugon:

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

GET /v1/users/me

Impormasyon ng User

Mag-query ng pangunahing impormasyon ng kasalukuyang user

Halimbawa ng tugon:

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

Pamamahala ng Order

Lumikha at mag-query ng mga energy order

POST /v1/energy/orders

Lumikha ng Order

Lumikha ng energy rental order para sa partikular na address (sa kasalukuyan ay sumusuporta lang ng manual type)

Mga parameter ng kahilingan:

Parameter	Uri	Kinakailangan	Paglalarawan
type	string	Oo	Uri ng order, sa kasalukuyan ay sumusuporta lang ng "manual"
data.tronAddress	string	Oo	TRON address na makakatanggap ng energy (34 characters, nagsisimula sa T)
data.energyValue	int64	Oo	Halaga ng energy (numero, minimum 32000, inirerekomenda ang 65000 para sa USDT transfer)
data.durationHours	int	Oo	Tagal ng rental (sa oras, wastong halaga: 1, 24, 72, 168, 336, 720)

Halimbawa ng kahilingan:

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

Halimbawa ng tugon:

{
  "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

Mag-query ng Order

Mag-query ng detalye ng order gamit ang ID

Halimbawa ng tugon:

{
  "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

Listahan ng mga Order

Mag-query ng listahan ng mga order (sumusuporta ng pagination at filtering)

Mga parameter ng kahilingan:

Parameter	Uri	Kinakailangan	Paglalarawan
offset	number	Hindi	Simula ng punto, default 0
limit	number	Hindi	Bilang ng mga item kada pahina, default 20, maximum 100
status	string	Hindi	I-filter ayon sa katayuan ng order: processing, completed, failed

Halimbawa ng tugon:

{
  "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
  }
}

Pamamahala ng Address

Pamahalaan ang mga madalas gamitin na address

POST /v1/addresses

Magdagdag ng Address

I-save ang bagong address

Halimbawa ng kahilingan:

{
  "tronAddress": "TYour1Address2Here3...",
  "label": "Pangunahing Wallet",
  "isDefault": false
}

Halimbawa ng tugon:

{
  "data": {
    "id": 1,
    "tronAddress": "TYour1Address2Here3...",
    "label": "Pangunahing Wallet",
    "isDefault": false,
    "usageCount": 0,
    "createdAt": "2025-01-01T00:00:00Z"
  }
}

GET /v1/addresses

Listahan ng mga Address

Kunin ang listahan ng mga naka-save na address

Halimbawa ng tugon:

{
  "data": {
    "addresses": [
      {
        "id": 1,
        "tronAddress": "TYour1Address2Here3...",
        "label": "Pangunahing Wallet",
        "isDefault": true,
        "usageCount": 5,
        "lastUsedAt": "2025-01-15T10:30:00Z",
        "createdAt": "2025-01-01T00:00:00Z"
      }
    ],
    "total": 1
  }
}

GET /v1/addresses/:id

Detalye ng Address

Mag-query ng impormasyon ng address

Halimbawa ng tugon:

{
  "data": {
    "id": 1,
    "tronAddress": "TYour1Address2Here3...",
    "label": "Pangunahing Wallet",
    "isDefault": true,
    "usageCount": 5,
    "lastUsedAt": "2025-01-15T10:30:00Z",
    "createdAt": "2025-01-01T00:00:00Z"
  }
}

PUT /v1/addresses/:id/label

I-update ang Label ng Address

Baguhin ang label ng address

Halimbawa ng kahilingan:

{
  "label": "Bagong Label"
}

Halimbawa ng tugon:

{
  "data": {
    "id": 1,
    "tronAddress": "TYour1Address2Here3...",
    "label": "Bagong Label",
    "isDefault": false,
    "usageCount": 3,
    "lastUsedAt": "2025-01-15T10:30:00Z",
    "createdAt": "2025-01-01T00:00:00Z"
  }
}

PUT /v1/addresses/:id/default

Itakda bilang Default Address

Itakda ang partikular na address bilang default recipient address

Halimbawa ng tugon:

// HTTP 204 No Content
// Walang content sa tugon

Nagbabalik ng 204 status nang walang content kapag matagumpay

DELETE /v1/addresses/:id

Tanggalin ang Address

Tanggalin ang naka-save na address