API प्रलेखन

EnergyFather सेवा USDT और अन्य TRC20 क्रिप्टो-टोकन में लेनदेन भेजने के लिए आवश्यक ऊर्जा और बैंडविड्थ खरीदने (किराए) में मदद करती है; TRON ब्लॉकचेन पर किसी भी प्रकार के लेनदेन को भेजने के लिए बैंडविड्थ की भी आवश्यकता होती है, जैसे TRX भेजना, पुरस्कारों का दावा करना और Super Representatives के लिए मतदान करना।

ऊर्जा खरीद प्रक्रिया

ऊर्जा खरीदने के लिए, आपको EnergyFather सेवा में पंजीकरण करना होगा, "खरीदार > API टोकन" पृष्ठ से प्राधिकरण टोकन प्राप्त करना होगा, और क्रेता खाते की शेष राशि को ऊपर करना होगा।

ऑर्डर बनाने के बाद (विधि ‘buy/energy’) ऊर्जा को कई सेकंड या मिनटों की देरी से वितरित किया जा सकता है, इसलिए स्वचालित सिस्टम विकसित करते समय समय-समय पर विधि ‘order/get/{guid}’ का अनुरोध करके ऑर्डर निष्पादन की जांच करने की अनुशंसा की जाती है।

उदाहरण के लिए, यदि आप USDT भेजने की योजना बना रहे हैं और ऊर्जा खरीदकर लेनदेन को सस्ता बनाना चाहते हैं, तो आप निम्न कार्य करते हैं:

  • आवश्यक ऊर्जा राशि का अनुमान लगाने और इसे खरीदने के लिए ‘buy/energy’ विधि का अनुरोध करें,
  • समय-समय पर ‘order/get/{guid}’ विधि का अनुरोध करें जब तक कि ऊर्जा प्रत्यायोजित न हो जाए (आमतौर पर इसमें कुछ सेकंड लगते हैं),
  • USDT भेजें (खरीदी गई ऊर्जा का उपयोग लेनदेन शुल्क का भुगतान करने के लिए किया जाएगा)।

सामान्य नोट्स

इस प्रलेखन में, ‘{guid}’ या ‘{id}’ जैसे घुंघराले ब्रेसिज़ में लिपटे एक अभिव्यक्ति का अर्थ है संबंधित चर का मूल्य:

  • ‘{guid}’ EnergyFather (आमतौर पर 8 अंक) में वस्तु का वैश्विक विशिष्ट पहचानकर्ता है,
  • ‘{id}’ इस उपयोगकर्ता के लिए ऑब्जेक्ट की अनुक्रमिक संख्या है (नंबरिंग प्रत्येक उपयोगकर्ता के लिए ‘1’ से प्रारंभ होती है)।

API अंतिम बिंदु

https://panel.energyfather.com/api/v1/private

POST विधि का उपयोग करके अनुरोध भेजें।

अनुरोधों का प्राधिकरण

एक निजी API के अनुरोधों की पुष्टि (अधिकृत) करने के लिए, एक HTTP शीर्ष लेख पारित किया जाना चाहिए:

Token: {token}

प्राधिकरण टोकन का प्रबंधन नियंत्रण कक्ष में, "खरीदार > API टोकन" पृष्ठ पर स्थित है।

उदाहरण के लिए, आप निम्न तरीके से ऑर्डर 123456 के बारे में जानकारी प्राप्त कर सकते हैं:

CURL -X POST 'https://panel.energyfather.com/api/v1/private/order/get/123456' 
-H 'Token: 123456xxxxxxxxxxxxxxxxxxxxxxNOPQRS'

आदेश की स्थिति

  • "0" - लंबित। आदेश अभी बनाया गया है।
  • "1" - भुगतान की प्रतीक्षा में। भुगतान लिंक पहले ही उत्पन्न हो चुका है, EnergyFather भुगतान प्रणाली से कॉलबैक की प्रतीक्षा कर रहा है। इस स्थिति का उपयोग नहीं किया जाता है यदि आदेश का भुगतान पूरी तरह से आंतरिक खाते में उपलब्ध धन द्वारा किया जाता है।
  • "2" - ऊर्जा प्रत्यायोजन की प्रक्रिया जारी है।
  • "3" - प्रत्यायोजित। ऊर्जा बाहर दी जाती है।
  • "4" - पुनः प्राप्त (अप्रत्यायोजित)। भुगतान की गई समय अवधि के अंत के कारण ऊर्जा वापस ले ली जाती है।
  • "5" - भुगतान किया गया। आदेश का भुगतान किया जाता है और ऊर्जा वितरण के लिए कतार में जोड़ा जाता है।
  • "6" - त्रुटि।

स्थितियों का सामान्य क्रम: 0, 5, 2, 3, 4।

API तरीके
  • /api/v1/private/buy/energy - ऊर्जा खरीदें (आंतरिक खाते से भुगतान किया गया)
  • /api/v1/private/order/list - अपने आदेशों की एक सूची प्राप्त करें
  • /api/v1/private/order/get/{guid} - अपने आदेश के बारे में जानकारी प्राप्त करें
  • /api/v1/private/account/list - अपने आंतरिक खातों की सूची प्राप्त करें
  • /api/v1/private/account/get/{id} - अपने आंतरिक खाते के बारे में जानकारी प्राप्त करें

"buy/energy" विधि - ऊर्जा खरीदें (आंतरिक खाते से भुगतान किया गया)

आंतरिक खाते से डेबिट के साथ एक पंजीकृत ग्राहक द्वारा ऊर्जा खरीदने का अनुरोध। ऊर्जा तुरंत निर्दिष्ट पते पर भेजी जाती है।

यदि आंतरिक खाते में अपर्याप्त धनराशि है, तो ऑर्डर बनाया जाएगा और तुरंत स्थिति "6" (त्रुटि) प्राप्त कर ली जाएगी। इस मामले में आपको पैनल पर जाने, कुछ फंड जमा करने और फिर ऊर्जा खरीदने के लिए एक नया API अनुरोध भेजने की आवश्यकता है।

खरीदी जाने वाली ऊर्जा की मात्रा को परिभाषित करने के दो तरीके हैं:

a) आप "amount" पैरामीटर में सटीक ऊर्जा राशि निर्धारित कर सकते हैं, फिर आपको amount_source="amount" भी सेट करना चाहिए।

b) यदि आप नहीं जानते कि USDT या कोई अन्य टोकन भेजने के लिए लेनदेन के लिए कितनी ऊर्जा की आवश्यकता है, तो आप amount_source="estimate" सेट कर सकते हैं और उपयुक्त पैरामीटर (estimate_to, estimate_token, estimate_adjust_percent) भर सकते हैं।

buy/energy: ऊर्जा की सटीक मात्रा के साथ उदाहरण अनुरोध

curl -X 'POST' 
  'https://panel.energyfather.com/api/v1/private/buy/energy' 
  -H 'Token: 123456xxxxxxxxxxxxxxxxxxxxxxNOPQRS' 
  -d '{
    "format": "json",
    "to":     "TQHAAJWLLEjBgYq2sjUnq4kbKfajEXEvyE",
    "amount_source": "amount", 
    "amount": "31895",
    "period_type": "days",
    "period_amount": "3"
}'

buy/energy: ऊर्जा की आवश्यक मात्रा की गणना के साथ उदाहरण अनुरोध

curl -X 'POST' 
  'https://panel.energyfather.com/api/v1/private/buy/energy' 
  -H 'Token: 123456xxxxxxxxxxxxxxxxxxxxxxNOPQRS' 
  -d '{
    "format": "json",
    "to":     "TQHAAJWLLEjBgYq2sjUnq4kbKfajEXEvyE",
    "amount_source": "estimate", 
    "estimate_to": "TLVkYEp4Ue2RpK5v1XNZAB3769g44BSZyH,TJm6HiCMVZdBHbNHThdMv1RambstJPrfYo",
    "estimate_token": "USDT",
    "estimate_adjust_percent": 0.04,
    "period_type": "days",
    "period_amount": "3"
}'

buy/energy: अनुरोध params

  • to (स्ट्रिंग, आवश्यक) - TRON पता जिस पर ऊर्जा प्रत्यायोजित की जानी है
  • period_amount (पूर्णांक, आवश्यक) - ऊर्जा खरीदने के लिए समय अवधि
  • period_type (स्ट्रिंग, आवश्यक) – समय अवधि का प्रकार। संभावित मान: days, hours।
  • format (स्ट्रिंग, वैकल्पिक) – प्रतिक्रिया प्रारूप। संभावित मान: json (default), xml.
  • amount_source (स्ट्रिंग, आवश्यक) - प्रत्यायोजित ऊर्जा की मात्रा निर्धारित करने के लिए एल्गोरिथ्म। यदि मान "amount" है, तो पैरामीटर "amount" का मान उपयोग किया जाता है। यदि मान "estimate" है, तो ऊर्जा की आवश्यक मात्रा की गणना estimate_to, estimate_token, estimate_adjust_percent मापदंडों के आधार पर की जाती है। संभावित मान: amount, estimate.
  • amount (पूर्णांक, amount_source="amount" की आवश्यकता होने पर आवश्यक) - खरीदी जाने वाली ऊर्जा की मात्रा। इसे नजरअंदाज कर दिया जाता है अगर amount_source="estimate"।
  • estimate_to (स्ट्रिंग, amount_source="estimate" की आवश्यकता है) - TRON पतों की अल्पविराम से अलग सूची जिसमें टोकन लेनदेन भेजने की योजना है
  • estimate_token (स्ट्रिंग, amount_source="estimate" आवश्यक है) - TRC20 टोकन। संभावित मान (केस-संवेदनशील): USDT, USDC, USDD, USDJ, JST, TUSD, stUSDT, WTRX.
  • estimate_adjust_percent (दशमलव, amount_source="estimate" के लिए आवश्यक) - प्रतिशत के रूप में व्यक्त की गई अतिरिक्त ऊर्जा राशि। TRX को जलाने से बचने के लिए इस अतिरिक्त की आवश्यकता होती है, जो तब हो सकता है जब पते में ऊर्जा की आवश्यक मात्रा हो। अनुशंसित मूल्य 0.04%. है

महत्वपूर्ण: वर्तमान में, केवल 6 अवधि मान्य हैं: 1 hour और 1, 3, 7, 15, 30 days.

buy/energy: प्रतिक्रिया

सफलता के मामले में, प्रतिक्रिया में GUID का आदेश होगा, जिसके द्वारा आप बाद में इसका वास्तविक विवरण प्राप्त कर सकते हैं।

{
	"status": "ok",
	"data": {
		"guid": 81373165,
		"estimate_task_id": null,
		"status": 0,
		"order_cost": "6.051",
		"to": "TQHAAJWLLEjBgYq2sjUnq4kbKfajEXEvyE",
		"energy_amount": 61000,
		"period_type": "hours",
		"energy_delegation_fee": "0.561000000000000000",
		"address_activation_fee": "0.000000000000000000",
		"hours": 1,
		"days": 0,
		"estimate_task": null
	},
	"balance": "7.29412"
}

यदि अनुरोध में amount_source="estimate" है तो प्रतिक्रिया में एक अतिरिक्त अनुभाग "estimate_task" है। उदाहरण के लिए:

{
	"status": "ok",
	"data": {
		"guid": 77082757,
		"estimate_task_id": 42708906,
		"status": 0,
		"order_cost": "0.561",
		"to": "TQHAAJWLLEjBgYq2sjUnq4kbKfajEXEvyE",
		"energy_amount": null,
		"period_type": "hours",
		"energy_delegation_fee": "0.561000000000000000",
		"address_activation_fee": "0.000000000000000000",
		"hours": 1,
		"days": 0,
		"estimate_task": {
			"id": 42708906,
			"token": "USDT",
			"currency": "USD",
			"from": "TQHAAJWLLEjBgYq2sjUnq4kbKfajEXEvyE",
			"to": [
				"TLVkYEp4Ue2RpK5v1XNZAB3769g44BSZyH",
				"TJm6HiCMVZdBHbNHThdMv1RambstJPrfYo"
			]
		}
	},
	"balance": "18.29412"
}

buy/energy: प्रतिक्रिया पैरामीटर

  • guid - आदेश GUID
  • balance - वर्तमान में आंतरिक खाते, TRX में उपलब्ध धन
  • days - दिनों में ऊर्जा प्रावधान की अवधि, यदि "period_type=days"
  • hours - घंटों में ऊर्जा प्रावधान की अवधि, यदि "period_type=hours"
  • estimate_task - एक TRON पते से दूसरे TRON पते की सूची में TRC20 लेनदेन भेजने के लिए आवश्यक ऊर्जा की गणना (अनुमान)

"order/get/{guid}" विधि - आदेश का विवरण प्राप्त करना

विशिष्ट आदेश के बारे में जानकारी प्राप्त करना।

order/get/{guid} - उदाहरण अनुरोध

curl -X 'POST' 
  'https://panel.energyfather.com/api/v1/private/order/get/12345' 
  -H 'Token: 123456xxxxxxxxxxxxxxxxxxxxxxNOPQRS'

order/get/{guid} - उदाहरण प्रतिक्रिया

{
	"status": "ok",
	"data": {
		"guid": 81373165,
		"estimate_task_id": 32301594,
		"status": 3,
		"payment_status": 0,
		"order_cost_paid": "4.146350000000000000",
		"order_cost": "4.146350000000000000",
		"to": "TQHAAJWLLEjBgYq2sjUnq4kbKfajEXEvyE",
		"energy_amount": 31895,
		"period_type": "hours",
		"energy_delegation_fee": "0.000000000000000000",
		"address_activation_fee": "0.000000000000000000",
		"hours": 1,
		"days": 0,
		"resource_txs": [
			{
				"order_guid": 81373165,
				"delegate_txid": "961b6fbd7cc2090d1a65abc06bfabde1046e02d35394f6eca8d05812a6e3ab7"
			}
		],
		"estimate_task": {
			"id": 42708906,
			"token": "USDT",
			"currency": "USD",
			"from": "TQHAAJWLLEjBgYq2sjUnq4kbKfajEXEvyE",
			"to": [
				"TLVkYEp4Ue2RpK5v1XNZAB3769g44BSZyH",
				"TJm6HiCMVZdBHbNHThdMv1RambstJPrfYo"
			]
		}
	}
}

order/get/{guid} – प्रतिक्रिया params

  • guid - आदेश GUID
  • balance - वर्तमान में आंतरिक खाते, TRX में उपलब्ध धन
  • days - दिनों में ऊर्जा प्रावधान की अवधि, यदि "period_type=days"
  • hours - घंटों में ऊर्जा प्रावधान की अवधि, यदि "period_type=hours"
  • to - TRX पता जहां ऊर्जा वितरित की जाती है
  • energy_amount - ऊर्जा मात्रा
  • order_cost - आदेश लागत, TRX
  • order_cost_paid - पहले से भुगतान की गई राशि, TRX (आंतरिक खाते में अपर्याप्त धनराशि के मामले में यह राशि "order_cost" से कम होगी)
  • address_activation_fee - गंतव्य पते के सक्रियण के लिए शुल्क की राशि, TRX
  • energy_delegation_fee - बहुत छोटे ऑर्डर आकार के लिए शुल्क, TRX
  • resource_txs - TRON ब्लॉकचेन में लेनदेन की सूची वाली सरणी जहां संसाधनों को प्रत्यायोजित और पुनः प्राप्त किया जाता है (अप्रत्यायोजित)
  • status – आदेश की स्थिति, संभावित मूल्यों को इस मैनुअल की शुरुआत में वर्णित किया गया है
  • payment_status - भुगतान प्रणाली में आदेश भुगतान की स्थिति (संभावित मूल्य भुगतान प्रणाली पर निर्भर करते हैं)

"order/list" विधि - आदेशों की सूची प्राप्त करना

आदेशों की सूची प्राप्त करना।

order/list - उदाहरण अनुरोध

curl -X 'POST' 
  'https://panel.energyfather.com/api/v1/private/order/list' 
  -H 'Token: 123456xxxxxxxxxxxxxxxxxxxxxxNOPQRS'

order/list - अनुरोध params

  • sort (स्ट्रिंग, वैकल्पिक) - प्रविष्टियों की छँटाई, डिफ़ॉल्ट रूप से "created_at|desc"
  • per_page (पूर्णांक, वैकल्पिक) - प्रति प्रतिक्रिया प्रविष्टियों की संख्या सीमित करें
  • page (पूर्णांक, वैकल्पिक) - प्रतिक्रिया पृष्ठ की अनुक्रमिक संख्या
  • filter (arrays(objects) की सरणी, वैकल्पिक) - प्रविष्टियों का फ़िल्टर

order/list - उदाहरण प्रतिक्रिया

{
	"current_page": 1,
	"data": [
		{
			"guid": 96134274,
			"status": 4
		},
		{
			"guid": 81373165,
			"status": 3
		}
	],
	"first_page_url": "/api/v1/private/order/list?page=1",
	"from": 1,
	"last_page": 1,
	"last_page_url": "/api/v1/private/order/list?page=1",
	"links": [
		{
			"url": null,
			"label": "pagination.previous",
			"active": false
		},
		{
			"url": "/api/v1/private/order/list?page=1",
			"label": "1",
			"active": true
		},
		{
			"url": null,
			"label": "pagination.next",
			"active": false
		}
	],
	"next_page_url": null,
	"path": "/api/v1/private/order/list",
	"per_page": 15,
	"prev_page_url": null,
	"to": 2,
	"total": 2,
	"draw": null,
	"status": "ok"
}

order/list – प्रतिक्रिया params

  • guid - आदेश का GUID
  • status - API प्रतिक्रिया की स्थिति

"account/list" विधि - आंतरिक खातों की सूची

आंतरिक खातों की एक सूची प्राप्त करना, जिसमें वर्तमान में उपलब्ध धन की राशि शामिल है। चूंकि साइट (buyer, affiliate, seller, dealer) के प्रत्येक अनुभाग के लिए एक अलग आंतरिक खाता है, इसलिए खाते में कई खाते हैं।

account/list - उदाहरण अनुरोध

curl -X 'POST' 
  'https://panel.energyfather.com/api/v1/private/account/list' 
  -H 'Token: 123456xxxxxxxxxxxxxxxxxxxxxxNOPQRS'

account/list - उदाहरण प्रतिक्रिया

{
	"current_page": 1,
	"data": [
		{
			"guid": 29778748,
			"user_id": 81841325,
			"id": 1,
			"section": "affiliate",
			"currency": "TRX",
			"balance": "2.511531"
		},
		{
			"guid": 64463815,
			"user_id": 81841325,
			"id": 2,
			"section": "buyer",
			"currency": "TRX",
			"balance": "41.704"
		}
	],
	"first_page_url": "/api/v1/private/account/list?page=1",
	"from": 1,
	"last_page": 1,
	"last_page_url": "/api/v1/private/account/list?page=1",
	"links": [
		{
			"url": null,
			"label": "pagination.previous",
			"active": false
		},
		{
			"url": "/api/v1/private/account/list?page=1",
			"label": "1",
			"active": true
		},
		{
			"url": null,
			"label": "pagination.next",
			"active": false
		}
	],
	"next_page_url": null,
	"path": "/api/v1/private/account/list",
	"per_page": 15,
	"prev_page_url": null,
	"to": 2,
	"total": 2,
	"draw": null,
	"status": "ok"
}

account/list – प्रतिक्रिया params

  • guid - आंतरिक खाते के GUID
  • id - आंतरिक खाते का अनुक्रमिक ID
  • section - यह शेष राशि किस EnergyFather अनुभाग से संबंधित है?
  • balance - उपलब्ध धन
  • currency - मुद्रा
  • user_id - उपयोगकर्ता के GUID

"account/get/{id}" विधि - सटीक आंतरिक खाता प्राप्त करना

EnergyFather के एक विशिष्ट खंड के लिए आंतरिक खाते का संतुलन प्राप्त करना। चूंकि प्रत्येक अनुभाग का अपना खाता (buyer, affiliate, seller, dealer) है, इसलिए प्रत्येक उपयोगकर्ता के लिए कई खाते हैं। आप पहले उनकी सूची प्राप्त करने के लिए "account/list" पद्धति का उपयोग कर सकते हैं, ब्याज के खाते के ‘id’ का पता लगा सकते हैं, और फिर किसी विशेष खाते की शेष राशि प्राप्त करने के लिए इस ‘id’ का उपयोग कर सकते हैं।

account/get/{id} - उदाहरण अनुरोध

curl -X 'POST' 
  'https://panel.energyfather.com/api/v1/private/account/get/1' 
  -H 'Token: 123456xxxxxxxxxxxxxxxxxxxxxxNOPQRS'

account/get/{id} - उदाहरण प्रतिक्रिया

{
	"status": "ok",
	"data": {
		"guid": 64463815,
		"user_id": 81841325,
		"id": 2,
		"section": "buyer",
		"currency": "TRX",
		"balance": "41.704"
	}
}

account/get/{id} – प्रतिक्रिया params

  • guid - आंतरिक खाते के GUID
  • id - आंतरिक खाते की अनुक्रमिक आईडी
  • section - यह शेष राशि किस EnergyFather अनुभाग से संबंधित है
  • balance - उपलब्ध फंड
  • currency - मुद्रा
  • user_id - उपयोगकर्ता के GUID