API TronRental للمبتدئين: شراء طاقة TRON في 7 خطوات
دليل خطوة بخطوة للمطورين بدون خبرة في TRON. من التسجيل إلى أول عملية شراء طاقة عبر API.
لمن هذا الدليل؟
هذا الدليل للمطورين، ومنشئي البوتات، وأصحاب الأعمال الذين يريدون أتمتة شراء طاقة ونطاق ترددي TRON. لا يتطلب خبرة سابقة في TRON.
بنهاية هذا الدليل ستتمكن من التحقق من الأسعار، وشراء الطاقة والنطاق الترددي، والتحقق من حالة الطلبات — كل ذلك من الكود الخاص بك.
ما يمكنك بناؤه مع API:
بوت يشتري الطاقة تلقائياً قبل كل تحويل USDT
التكامل مع بورصتك أو محفظتك أو خدمة الدفع الخاصة بك
شراء طاقة بالجملة لعناوين متعددة دفعة واحدة
ما هو API ولماذا تستخدمه؟
API (واجهة برمجة التطبيقات) هي طريقة للتحكم في الخدمة من الكود بدلاً من النقر على الأزرار في الموقع. فكر فيها كجهاز تحكم عن بعد لـ TronRental.
مع API TronRental يمكنك فعل كل ما يفعله الموقع — التحقق من الأسعار، شراء الطاقة، شراء النطاق الترددي — لكن تلقائياً من سكربت أو خادم.
يدوي مقابل API
يدوي: افتح الموقع، سجل الدخول، أدخل العنوان، اختر الحجم، انقر شراء، انتظر، كرر
API: طلب HTTP واحد ← تُفوَّض الطاقة في ثوانٍ. لا حاجة لمتصفح.
الخطوة 1 — التسجيل وتسجيل الدخول
انتقل إلى tronrental.com وأنشئ حساباً. يمكنك التسجيل بالبريد الإلكتروني أو Google أو Telegram أو محفظة TronLink.
بعد التسجيل، انتقل إلى لوحة التحكم. هنا تدير كل شيء: الرصيد والطلبات ومفاتيح API والإعدادات.
الخطوة 2 — إنشاء مفتاح API
في لوحة التحكم، انتقل إلى قسم API وانقر "Create API Key".
مهم: يُعرض مفتاح API مرة واحدة فقط. انسخه واحفظه في مكان آمن. إذا فقدته ستحتاج لإنشاء واحد جديد.
مفتاح API مثل كلمة مرور لسكربتك. يخبر TronRental من يقوم بالطلب ويخصم من رصيد حسابك.
اختياري: يمكنك تقييد المفتاح لعناوين IP محددة لمزيد من الأمان. فقط الطلبات من تلك العناوين ستُقبل.
اختياري: عيّن عنوان Webhook لتلقي إشعارات تلقائية عند تغيير حالة الطلب.
الخطوة 3 — إيداع الأموال
انتقل إلى لوحة التحكم ← Deposit وانسخ عنوان الإيداع الشخصي.
أرسل TRX أو USDT (TRC-20) إلى هذا العنوان. يتم تأكيد الإيداع عادة خلال 30 ثانية.
يمكنك التحقق من رصيدك عبر API:
curl -X GET https://tronrental.com/api/v1/account/balance \
-H "Authorization: Bearer YOUR_API_KEY"# Python
import requests
API_KEY = "YOUR_API_KEY"
headers = {"Authorization": f"Bearer {API_KEY}"}
r = requests.get("https://tronrental.com/api/v1/account/balance", headers=headers)
print(r.json())// JavaScript (Node.js)
const API_KEY = "YOUR_API_KEY";
const res = await fetch("https://tronrental.com/api/v1/account/balance", {
headers: { "Authorization": `Bearer ${API_KEY}` }
});
console.log(await res.json());الاستجابة:
{
"balance_trx": "150.50",
"balance_usdt": "0.00",
"deposit_address": "TYour1Deposit2Address3Here..."
}الخطوة 4 — التحقق من الأسعار الحالية
قبل الشراء، تحقق من الأسعار الحالية. هذا الطلب عام — لا يتطلب مفتاح API.
curl -X GET https://tronrental.com/api/v1/prices# Python
import requests
r = requests.get("https://tronrental.com/api/v1/prices")
print(r.json())// JavaScript
const res = await fetch("https://tronrental.com/api/v1/prices");
console.log(await res.json());الاستجابة:
{
"energy": {
"1h": "0.84",
"1d": "4.20"
},
"bandwidth": {
"1d": "9.60"
},
"burn_cost_trx": "6.43",
"savings_percent": "87"
}شرح حقول الاستجابة:
- energy.1h — سعر 1,000 وحدة طاقة لمدة ساعة (بـ TRX)
- bandwidth — سعر 1,000 وحدة نطاق ترددي ليوم (بـ TRX)
- burn_cost_trx — كم TRX ستحرق بدون طاقة
- savings_percent — كم توفر بالاستئجار مقارنة بالحرق
صيغة السعر: price_per_1k × (volume / 1000). مثلاً، إذا كان energy.1h = 0.84 TRX وتحتاج 65,000 طاقة: 0.84 × 65 = 54.6 TRX.
الخطوة 5 — شراء الطاقة
الآن الجزء الرئيسي — شراء الطاقة. أرسل طلب POST مع عنوان الهدف والحجم والمدة.
المعاملات:
target_address— عنوان TRON الذي سيتلقى الطاقةvolume— كمية الطاقة (الحد الأدنى 32,000، الحد الأقصى 5,000,000)duration— فترة الإيجار: "1h" (ساعة) أو "1d" (يوم)
كم طاقة تحتاج؟ لتحويل USDT: 65,000 إذا كان المستلم يملك USDT بالفعل، أو 131,000 إذا لم يكن.
الطلب:
curl -X POST https://tronrental.com/api/v1/energy/buy \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"target_address": "TReceiverAddress...",
"volume": 65000,
"duration": "1h"
}'# Python
import requests
API_KEY = "YOUR_API_KEY"
headers = {
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json"
}
data = {
"target_address": "TReceiverAddress...",
"volume": 65000,
"duration": "1h"
}
r = requests.post("https://tronrental.com/api/v1/energy/buy",
headers=headers, json=data)
print(r.json())// JavaScript (Node.js)
const API_KEY = "YOUR_API_KEY";
const res = await fetch("https://tronrental.com/api/v1/energy/buy", {
method: "POST",
headers: {
"Authorization": `Bearer ${API_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
target_address: "TReceiverAddress...",
volume: 65000,
duration: "1h"
})
});
console.log(await res.json());الاستجابة:
{
"id": 1234,
"type": "energy",
"target_address": "TReceiverAddress...",
"volume": 65000,
"duration": "1h",
"price_trx": "54.60",
"status": "pending",
"created_at": "2026-02-28T12:00:00Z"
}حالات الطلب:
- pending — الطلب أُنشئ، بانتظار المعالجة
- delegated — تم تفويض الطاقة إلى العنوان المحدد
- completed — انتهت فترة الإيجار، تم استرداد الطاقة
الخطوة 6 — شراء النطاق الترددي
النطاق الترددي يعمل بنفس طريقة الطاقة. مطلوب لأي معاملة TRON (ليس فقط USDT).
المعاملات:
target_address— عنوان TRON الذي سيتلقى النطاق التردديvolume— كمية النطاق الترددي (الحد الأدنى 350، الحد الأقصى 100,000)duration— فترة الإيجار: "1h"
يتم إضافة رسم ثابت قدره 0.2 TRX لكل طلب نطاق ترددي.
الطلب:
curl -X POST https://tronrental.com/api/v1/bandwidth/buy \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"target_address": "TReceiverAddress...",
"volume": 5000,
"duration": "1h"
}'# Python
import requests
API_KEY = "YOUR_API_KEY"
headers = {
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json"
}
data = {
"target_address": "TReceiverAddress...",
"volume": 5000,
"duration": "1h"
}
r = requests.post("https://tronrental.com/api/v1/bandwidth/buy",
headers=headers, json=data)
print(r.json())// JavaScript (Node.js)
const API_KEY = "YOUR_API_KEY";
const res = await fetch("https://tronrental.com/api/v1/bandwidth/buy", {
method: "POST",
headers: {
"Authorization": `Bearer ${API_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
target_address: "TReceiverAddress...",
volume: 5000,
duration: "1h"
})
});
console.log(await res.json());الاستجابة:
{
"id": 1235,
"type": "bandwidth",
"target_address": "TReceiverAddress...",
"volume": 5000,
"duration": "1h",
"price_trx": "2.20",
"status": "pending",
"created_at": "2026-02-28T12:05:00Z"
}الخطوة 7 — التحقق من حالة الطلب
بعد تقديم الطلب، يمكنك التحقق من حالته في أي وقت.
الحصول على جميع الطلبات:
curl -X GET https://tronrental.com/api/v1/orders \
-H "Authorization: Bearer YOUR_API_KEY"الحصول على طلب محدد بالمعرف:
curl -X GET https://tronrental.com/api/v1/orders/1234 \
-H "Authorization: Bearer YOUR_API_KEY"# Python
import requests
API_KEY = "YOUR_API_KEY"
headers = {"Authorization": f"Bearer {API_KEY}"}
# All orders
orders = requests.get("https://tronrental.com/api/v1/orders",
headers=headers).json()
# Single order
order = requests.get("https://tronrental.com/api/v1/orders/1234",
headers=headers).json()
print(order["status"]) # "delegated"الاستجابة:
{
"id": 1234,
"type": "energy",
"target_address": "TReceiverAddress...",
"volume": 65000,
"duration": "1h",
"price_trx": "54.60",
"status": "delegated",
"delegate_txid": "abc123def456...",
"created_at": "2026-02-28T12:00:00Z",
"delegated_at": "2026-02-28T12:00:04Z"
}ابحث عن حقل "status". عندما يظهر "delegated"، تم تسليم الطاقة أو النطاق الترددي بنجاح. حقل "delegate_txid" يحتوي على هاش المعاملة.
أفضل الممارسات والنصائح
الأمان
لا تضع مفتاح API في الكود مباشرة. استخدم متغيرات البيئة:
Python:
import os
API_KEY = os.environ["TRONRENTAL_API_KEY"]JavaScript/Node.js:
const API_KEY = process.env.TRONRENTAL_API_KEY;قائمة IP المسموحة
للإنتاج، عيّن دائماً قائمة IP المسموحة على مفتاح API. حتى لو تسرب المفتاح، لا يمكن استخدامه من خادم آخر.
حدود الطلبات
يسمح API بـ 30 طلباً كل 60 ثانية لكل مفتاح. عند التجاوز ستحصل على استجابة 429. أضف تأخيراً صغيراً بين الطلبات.
أخطاء شائعة
أكثر رموز الأخطاء شيوعاً وماذا تفعل:
401 Unauthorized — مفتاح API غير صالح أو مفقود.
400 Bad Request — معاملات غير صالحة. تحقق من رسالة الخطأ.
402 Payment Required — رصيد غير كافٍ. أودع المزيد من TRX.
429 Too Many Requests — تجاوز حد الطلبات. انتظر وأعد المحاولة.
الويب هوك
بدلاً من الاستعلام المتكرر عن الحالة، عيّن عنوان webhook. سيرسل TronRental طلب POST عند تغيير الحالة.
حمولة webhook تتضمن كائن الطلب الكامل مع الحالة المحدثة.
الأسئلة الشائعة
كم طاقة أحتاج لتحويل USDT؟
65,000 طاقة إذا كان المستلم يملك USDT بالفعل، أو 131,000 إذا لم يكن. استخدم حاسبة الطاقة للتحقق.
ما سرعة تفويض الطاقة؟
عادة خلال 3-5 ثوانٍ بعد تقديم الطلب.
ماذا يحدث إذا نفد رصيدي؟
سيعيد API خطأ 402. الطلبات الحالية تبقى نشطة حتى انتهاء مدتها. أودع المزيد من TRX وتابع.
هل يمكنني شراء طاقة لعنوان شخص آخر؟
نعم. يمكن أن يكون target_address أي عنوان TRON صالح. لست بحاجة لامتلاكه.
ما لغات البرمجة المدعومة؟
أي لغة تستطيع عمل طلبات HTTP. الأمثلة بـ Python وJavaScript وcurl، لكن يمكنك استخدام Go أو PHP أو Java أو أي لغة أخرى.