API प्रलेखन - EnergyFather.com

सेवा EnergyFather और अन्य TRC20 क्रिप्टो-टोकन में लेनदेन USDT भेजने के लिए आवश्यक ऊर्जा और बैंडविड्थ खरीदने (किराया) में मदद करती है; ब्लॉकचेन पर 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 अनुरोध भेजने की आवश्यकता है।

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

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

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

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 : प्रतिक्रिया params

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} - प्रतिक्रिया पैराम्स

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 - प्रतिक्रिया पैराम्स

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 - प्रतिक्रिया पैराम्स

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} - प्रतिक्रिया पैराम्स

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