TRON Energy Rental API — אוטומציה של העברות USDT TRC-20

TRON Energy Rental API: סקירה כללית ומקרי שימוש

ה-Quick Rent API הוא דרך לשכור את TRON Energy באופן אוטומטי, ללא עבודה ידנית. אנרגיה הופכת העברות USDT (TRC-20) ושיחות חוזים חכמים אחרים לזולים יותר מאשר שריפת TRX.

במילים פשוטות: התוכנית שלך (אתר, בוט או שירות) קונה אנרגיה בעצמה, בדיוק מתי שהיא נחוצה - למשל, לפני כל העברה של USDT שהלקוח שלך מבצע.

תחשוב על מכונה אוטומטית: אתה בודק את המחיר, מכניס כסף, מקבל את הפריט שלך. ה-API הוא אותה קבוצה של לחצנים - רק התוכנית שלך לוחצת עליהם.

התחלה מהירה: מאפס לאנרגיה

דוגמה מלאה מקצה לקצה על התרחיש הפשוט ביותר (על השרשרת). ארבעה צעדים ואנרגיה על הארנק.

להלן מה קורה בכל שלב ומה ה-API מחזיר. חבר את מפתח ה-API, הכתובות ומזהה ההזמנה שלך.

{
  "price_trx": "3.200000",
  "available": true,
  "save_percent": 62,
  "expires_in_sec": 30
}

{
  "id": "uuid",
  "status": "pending_payment",
  "payment_mode": "onchain",
  "pay_address": "TDeposit...",
  "amount_trx": "3.200000",
  "energy_amount": 131000,
  "duration_minutes": 15,
  "expires_at": "2026-04-29T13:15:00.000Z",
  "qr_payload": "tron:TDeposit...?amount=3.200000",
  "duplicate": false,
  "target_address": "TTarget..."
}

# poll every 3s until the order is done
while true; do
  STATUS=$(curl -sS "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID" \
    -H "Authorization: Bearer $API_KEY" | jq -r .status)
  echo "status: $STATUS"
  case "$STATUS" in
    delegated|failed|expired|cancelled) break ;;
  esac
  sleep 3
done

{
  "id": "uuid",
  "status": "delegated",
  "payment_mode": "onchain",
  "amount_trx": "3.200000",
  "energy_amount": 131000,
  "effective_energy_amount": 131000,
  "duration_minutes": 15,
  "pay_address": "TDeposit...",
  "payer_address": "TPayer...",
  "target_address": "TTarget...",
  "error_code": null,
  "error_message": null
}

מילון מונחים

הסברים קצרים למילים המשמשות בתיעוד זה.

לפני שמתחילים

מה להכין לפני הבקשה הראשונה.

כתובת ה-URL הבסיסית של ייצור API

ה-Quick Rent API מאפשר לשירות שלך לשכור את TRON Energy באופן אוטומטי, כך שהעברות USDT TRC-20 ושיחות חוזים חכמים אחרים עולים פחות משריפת TRX.

כל נקודות הקצה חולקות כתובת אתר בסיס אחת.

https://tronbid.com/api/v2/quick-rent

הרשאה

כל בקשה חייבת לכלול את מפתח ה-API שלך כ-Bearer token בכותרת ההרשאה.

שמור את המפתח בצד השרת בלבד (בקצה אחורי, סודות CI). לעולם אל תשלח אותו בקוד קצה או במאגרים ציבוריים. המפתח קשור לחשבון TronBid יחיד (הארנק שהוגדר בעת מתן הגישה); תשלומי יתרה יכולים למשוך רק מחשבון זה.

אם תחרוג ממגבלת הקצב, ה-API מגיב עם HTTP 429.

Authorization: Bearer <API_KEY>

מצבי תשלום

ישנן שתי דרכים לשלם עבור הזמנה. On-chain הוא ברירת המחדל ואינו זקוק להגדרה. תשלום היתרה הוא אופציונלי וחייב להיות מופעל עבור המפתח שלך.

ללא הפעלה, בקשה עם תשלום_מצב: יתרה מחזירה 403 BALANCE_PAYMENT_NOT_ENABLED. כדי להפעיל אותו, פנה לתמיכה של TronBid.

קטלוג חבילות

energy_amount ו-duration_minutes חייבים להתאים לחבילת השכרה מהירה פעילה - בדרך כלל 65000 או 131000 אנרגיה ו-15 או 60 דקות.

אחזר את הקטלוג הנוכחי בכל עת (אין צורך באישור):

curl -sS https://tronbid.com/api/public/quick-rent/skus

זרימה על השרשרת

שלב 1 - פרסם/הצעת מחיר כדי ללמוד את המחיר. שלב 2 - POST / orders ליצירת ההזמנה ולקבלת pay_address, amount_trx ו expires_at. שלב 3 - שלח בדיוק amount_trx TRX אל pay_address מכתובת המשלם שלך. שלב 4 - סקר GET /orders/:id עד להאצלת הסטטוס (או נכשל / פג / בוטל).

target_address הוא אופציונלי - אם מושמט, האנרגיה מואצלת לכתובת_המשלם.

רק הזמנה פתוחה אחת בשרשרת (pending_payment) מותרת לכל payer_address בכל פעם; אחרת תקבל 409 PENDING_PAYMENT_INTENT_EXISTS. בתשלום חסר/יתר, האנרגיה הסופית עשויה להיות שונה - בדוק כמות_אנרגיה_יעילות ב-GET /orders/:id.

{
  "energy_amount": 131000,
  "duration_minutes": 15,
  "idempotency_key": "your-unique-key-001",
  "payer_address": "TPayerWalletXXXXXXXXXXXXXXXXXXXXXX",
  "target_address": "TTargetWalletXXXXXXXXXXXXXXXXXXXXX"
}

{
  "id": "uuid",
  "status": "pending_payment",
  "payment_mode": "onchain",
  "pay_address": "TDeposit...",
  "amount_trx": "3.200000",
  "energy_amount": 131000,
  "duration_minutes": 15,
  "expires_at": "2026-04-29T13:15:00.000Z",
  "qr_payload": "tron:TDeposit...?amount=3.200000",
  "duplicate": false,
  "target_address": "TTarget..."
}

איזון זרימה

שלב 1 - קבל / איזון כדי לבדוק את ה-TRX שלך. שלב 2 - פרסם/הצעת מחיר עבור המחיר. שלב 3 - POST / הזמנות עם תשלום_mode: יתרה לחיוב והתחלת האצלה. שלב 4 - סקר GET /orders/:id עד להאצלה (בשגיאת האצלה זה הופך לכשל ו-TRX מוחזר ליתרה שלך).

אין צורך ב-payer_address - החשבון המקושר למפתח ה-API שלך משלם. האנרגיה_כמות בתגובה יכולה להיות גבוהה יותר מ-SKU שהוזמן (בונוס מטריצת מחיר).

{
  "energy_amount": 131000,
  "duration_minutes": 15,
  "idempotency_key": "your-unique-key-balance-001",
  "payment_mode": "balance",
  "target_address": "TTargetWalletXXXXXXXXXXXXXXXXXXXXX"
}

{
  "id": "uuid",
  "status": "delegating",
  "payment_mode": "balance",
  "pay_address": null,
  "amount_trx": "3.200000",
  "energy_amount": 132310,
  "duration_minutes": 15,
  "expires_at": null,
  "qr_payload": null,
  "duplicate": false,
  "target_address": "TTarget..."
}

סטטוסי הזמנה

כל הזמנה עוברת דרך הסטטוסים האלה. סקר GET /orders/:id כדי לעקוב אחריו.

אדמומיות

idempotency_key (8–128 תווים) הוא מזהה הזמנה ייחודי בצד שלך. חזרה על POST /הזמנות עם אותו מפתח (עבור אותו לקוח API) מחזירה את אותה הזמנה עם "כפול": true.

אין לעשות שימוש חוזר ב-idempotency_key אחד על פני מצבי תשלום שונים (onchain לעומת יתרה) - זה מחזיר 409 IDEMPOTENCY_PAYMENT_MODE_MISMATCH.

חשב את דרישות ההשכרה של TRON Energy

הערך כמה אנרגיה צריכה כתובת לצורך העברה. העבר את ארנק הנמען והאם הוא כבר מחזיק USDT.

{
  "wallet_address": "TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "has_usdt": true
}

curl -sS -X POST "$BASE_URL/api/v2/quick-rent/calculator" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"wallet_address":"TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX","has_usdt":true}'

קבל הצעת מחיר להשכרה של TRON Energy

מחזירה את המחיר הנוכחי לחבילה: price_trx, זמינות, save_percent וכמה זמן הצעת המחיר בתוקף (expires_in_sec).

{
  "price_trx": "3.200000",
  "available": true,
  "save_percent": 62,
  "expires_in_sec": 30
}

export BASE_URL="https://tronbid.com"
export API_KEY="your_api_key"

curl -sS -X POST "$BASE_URL/api/v2/quick-rent/quote" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"energy_amount":131000,"duration_minutes":15}'

צור הזמנת השכרה של TRON Energy

יוצר הזמנת השכרה. עבור רשת, העבר את Payer_address ושלם את הסכום שהוחזר ל-pay_address. עבור יתרה, הוסף תשלום_מצב: יתרה והחשבון המקושר יחויב באופן מיידי.

target_address היא אופציונלית (ברירת המחדל היא payer_address). שימו לב ל-409 הכללים: הזמנה אחת פתוחה בשרשרת לכל משלם, ואין משלחת פעילה של השכרה מהירה שכבר נמצאת ביעד (ACTIVE_DELEGATION_EXISTS).

{
  "id": "uuid",
  "status": "pending_payment",
  "payment_mode": "onchain",
  "pay_address": "TDeposit...",
  "amount_trx": "3.200000",
  "energy_amount": 131000,
  "duration_minutes": 15,
  "expires_at": "2026-04-29T13:15:00.000Z",
  "qr_payload": "tron:TDeposit...?amount=3.200000",
  "duplicate": false,
  "target_address": "TTarget..."
}

{
  "id": "uuid",
  "status": "delegating",
  "payment_mode": "balance",
  "pay_address": null,
  "amount_trx": "3.200000",
  "energy_amount": 132310,
  "duration_minutes": 15,
  "expires_at": null,
  "qr_payload": null,
  "duplicate": false,
  "target_address": "TTarget..."
}

curl -sS -X POST "$BASE_URL/api/v2/quick-rent/orders" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "energy_amount": 131000,
    "duration_minutes": 15,
    "idempotency_key": "partner-onchain-001",
    "payer_address": "TPayer...",
    "target_address": "TTarget..."
  }'

curl -sS -X POST "$BASE_URL/api/v2/quick-rent/orders" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "energy_amount": 131000,
    "duration_minutes": 15,
    "idempotency_key": "partner-balance-001",
    "payment_mode": "balance",
    "target_address": "TTarget..."
  }'

קבל סטטוס הזמנה

מחזירה את המצב הנוכחי, תשלום_מצב, סכומים, כתובות ו- error_code / error_message אם משהו נכשל. כמות_יעילות_אנרגיה משקפת את האנרגיה המואצלת בפועל לאחר תשלום-יתר.

{
  "id": "uuid",
  "status": "delegated",
  "payment_mode": "onchain",
  "amount_trx": "3.200000",
  "energy_amount": 131000,
  "effective_energy_amount": 131000,
  "duration_minutes": 15,
  "pay_address": "TDeposit...",
  "payer_address": "TPayer...",
  "target_address": "TTarget...",
  "error_code": null,
  "error_message": null
}

curl -sS "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID" \
  -H "Authorization: Bearer $API_KEY"

בטל הזמנה

מבטל הזמנה שעדיין בהמתנה_תשלום (בשרשרת בלבד). לאחר האצלת אנרגיה, לא ניתן עוד לבטל את ההזמנה.

curl -sS -X POST "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID/cancel" \
  -H "Authorization: Bearer $API_KEY"

שנה משלם

משנה את הארנק התשלום עבור הזמנה ממתינה_תשלום על שרשרת - שימושי אם הלקוח מחליט לשלם מארנק אחר לפני שליחת TRX.

curl -sS -X POST "$BASE_URL/api/v2/quick-rent/orders/$ORDER_ID/set-payer" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"payer_address":"TNewPayer..."}'

בדוק את יתרת ה-API של TronBid

מחזירה את יתרת ה-TRX של חשבון TronBid המקושר למפתח ה-API שלך (היתרה שלך בתוך האפליקציה, לא ארנק על השרשרת). דורש את כותרת ההרשאה.

{ "balance_trx": "150.500000" }

curl -sS "$BASE_URL/api/v2/quick-rent/balance" \
  -H "Authorization: Bearer $API_KEY"

קודי שגיאה

שגיאות מחזירות סטטוס HTTP ושדה שגיאה. הנה אלה שאתה עשוי להיתקל בהם.

אם משהו משתבש

מצבים נפוצים ומה לעשות, במילים פשוטות.

תמיכה באינטגרציה של TRON Energy API

זקוק לגישה ל-API, להגבלות גבוהות יותר או לאפשר תשלום יתרה? פנה ונעזור.