Dokumentasi API - EnergyFather.com

Perkhidmatan EnergyFather membantu membeli (menyewa) tenaga dan lebar jalur yang diperlukan untuk menghantar transaksi dalam USDT dan token kripto TRC20 yang lain; lebar jalur juga diperlukan untuk menghantar sebarang jenis transaksi pada rantaian blok TRON, seperti menghantar TRX, menuntut ganjaran dan mengundi untuk Super Representatives.

Prosedur pembelian tenaga

Untuk membeli tenaga, anda perlu mendaftar dalam perkhidmatan EnergyFather, ambil token kebenaran dari halaman "Pembeli > token API", dan tambah nilai baki akaun Pembeli.

Selepas membuat pesanan (kaedah ‘buy/energy’) tenaga boleh dihantar dengan kelewatan beberapa saat atau bahkan minit, jadi apabila membangunkan sistem automatik adalah disyorkan untuk menyemak pelaksanaan pesanan secara berkala dengan meminta kaedah ‘order/get/{guid}’.

Sebagai contoh, jika anda merancang untuk menghantar USDT dan ingin membuat transaksi lebih murah dengan membeli tenaga, anda melakukan perkara berikut:

minta kaedah ‘buy/energy’ untuk menganggarkan jumlah tenaga yang diperlukan dan membelinya,
secara berkala meminta kaedah ‘order/get/{guid}’ sehingga tenaga diwakilkan (biasanya ia mengambil masa beberapa saat),
hantar USDT (tenaga yang dibeli akan digunakan untuk membayar yuran transaksi).

Nota am

Dalam dokumentasi ini, ungkapan yang dibalut ke dalam pendakap kerinting seperti ‘{guid}’ atau ‘{id}’ bermaksud nilai pembolehubah yang sepadan:

‘{guid}’ ialah pengecam unik global objek dalam EnergyFather (biasanya 8 digit),
‘{id}’ ialah nombor jujukan objek untuk pengguna ini (penomboran bermula dengan ‘1’ untuk setiap pengguna).

API Titik Akhir

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

Hantar permintaan menggunakan kaedah POST.

Kebenaran permintaan

Untuk mengesahkan (membenarkan) permintaan kepada API persendirian, pengepala HTTP hendaklah diluluskan:

Token: {token}

Pengurusan token kebenaran terletak di panel kawalan, pada halaman "Pembeli > token API".

Sebagai contoh, anda boleh mendapatkan maklumat tentang pesanan 123456 dengan cara berikut:

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

Status pesanan

"0" - Belum selesai. Perintah itu baru sahaja dibuat.
"1" - Menunggu pembayaran. Pautan pembayaran telah dijana, EnergyFather sedang menunggu panggilan balik daripada sistem pembayaran. Status ini tidak digunakan jika pesanan dibayar sepenuhnya dengan dana yang tersedia di akaun dalaman.
"2" - Prosedur delegasi tenaga sedang dijalankan.
"3" - Diwakilkan. Tenaga diberikan.
"4" - Ditebus Guna (Tidak Diwakilkan). Tenaga ditarik balik kerana berakhirnya tempoh masa berbayar.
"5" - Dibayar. Pesanan dibayar dan dimasukkan ke dalam barisan untuk penghantaran tenaga.
"6" - Ralat.

Urutan status biasa: 0, 5, 2, 3, 4.

Kaedah API

/api/v1/private/buy/energy – beli tenaga (dibayar daripada akaun dalaman)
/api/v1/private/order/list - dapatkan senarai pesanan anda
/api/v1/private/order/get/{guid} - dapatkan maklumat mengenai pesanan anda
/api/v1/private/account/list – dapatkan senarai akaun dalaman anda
/api/v1/private/account/get/{id} – dapatkan maklumat mengenai akaun dalaman anda

Kaedah "buy/energy" – beli tenaga (dibayar daripada akaun dalaman)

Permintaan untuk membeli tenaga oleh pelanggan berdaftar dengan debit daripada akaun dalaman. Tenaga segera dihantar ke alamat yang ditentukan.

Jika akaun dalaman tidak mempunyai dana yang mencukupi, pesanan akan dibuat dan serta-merta mendapat status "6" (Ralat). Dalam kes ini, anda perlu melawat panel, mendepositkan sedikit dana dan kemudian menghantar permintaan API baharu untuk pembelian tenaga.

Terdapat dua cara untuk menentukan jumlah tenaga yang akan dibeli:

a) Anda boleh menetapkan jumlah tenaga yang tepat dalam parameter "amount", maka anda juga harus menetapkan amount_source="amount".

b) Jika anda tidak tahu berapa banyak tenaga yang diperlukan untuk transaksi untuk menghantar USDT atau token lain, anda boleh menetapkan amount_source="estimate" dan mengisi parameter (estimate_to, estimate_token, estimate_adjust_percent).

buy/energy: Contoh permintaan dengan jumlah tenaga yang tepat

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: Contoh permintaan dengan pengiraan jumlah tenaga yang diperlukan

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: Param permintaan

to (rentetan, diperlukan) – Alamat TRON yang mana tenaga akan diwakilkan
period_amount (integer, diperlukan) – tempoh masa untuk membeli tenaga
period_type (rentetan, diperlukan) – jenis tempoh masa. Nilai yang mungkin: days, hours.
format (rentetan, pilihan) – format respons. Nilai yang mungkin: json (default), xml.
amount_source (rentetan, diperlukan) – algoritma untuk menentukan jumlah tenaga yang diwakilkan. Jika nilainya ialah "amount", maka nilai parameter "amount" digunakan. Jika nilainya ialah "estimate", jumlah tenaga yang diperlukan dikira berdasarkan parameter estimate_to, estimate_token, estimate_adjust_percent. Nilai yang mungkin: amount, estimate.
amount (integer, diperlukan jika amount_source="amount") – jumlah tenaga yang akan dibeli. Ia diabaikan jika amount_source="estimate".
estimate_to (rentetan, diperlukan jika amount_source="estimate") – senarai alamat TRON yang dipisahkan koma yang mana transaksi token dirancang untuk dihantar
estimate_token (rentetan, diperlukan jika amount_source="estimate") – token TRC20. Nilai yang mungkin (sensitif huruf besar): USDT, USDC, USDD, USDJ, JST, TUSD, stUSDT, WTRX.
estimate_adjust_percent (perpuluhan, diperlukan jika amount_source="estimate") – jumlah tenaga berlebihan yang dinyatakan sebagai peratusan. Lebihan ini diperlukan untuk mengelakkan pembakaran TRX, yang mungkin berlaku jika alamat mempunyai jumlah tenaga yang diperlukan. Nilai yang disyorkan ialah 0.04%.

Penting: Pada masa ini, hanya 6 tempoh yang sah: 1 hour dan 1, 3, 7, 15, 30 days.

buy/energy: Respons

Sekiranya berjaya, respons akan mengandungi pesanan GUID, yang mana anda boleh mendapatkan butiran sebenar kemudian.

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

Jika permintaan mengandungi amount_source="estimate" maka respons mempunyai bahagian tambahan "estimate_task". Sebagai contoh:

{
	"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: Parameter respons

guid – perintah GUID
balance – dana yang kini tersedia dalam akaun dalaman, TRX
days – tempoh peruntukan tenaga dalam hari, jika "period_type=days"
hours – tempoh peruntukan tenaga dalam jam, jika "period_type=hours"
estimate_task – pengiraan (anggaran) tenaga yang diperlukan untuk menghantar transaksi TRC20 daripada satu alamat TRON ke senarai alamat TRON yang lain

Kaedah "order/get/{guid}" – mendapatkan butiran pesanan

Mendapatkan maklumat mengenai pesanan tertentu.

order/get/{guid} – Contoh permintaan

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

order/get/{guid} – Contoh respons

{
	"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} – Parameter respons

guid – perintah GUID
balance – dana yang kini tersedia dalam akaun dalaman, TRX
days – tempoh peruntukan tenaga dalam hari, jika "period_type=days"
hours – tempoh peruntukan tenaga dalam jam, jika "period_type=hours"
to – Alamat TRX di mana tenaga dihantar
energy_amount – kuantiti tenaga
order_cost – kos pesanan, TRX
order_cost_paid – jumlah yang telah dibayar, TRX (sekiranya dana tidak mencukupi dalam akaun dalaman, jumlah ini akan kurang daripada "order_cost")
address_activation_fee – jumlah yuran untuk pengaktifan alamat destinasi, TRX
energy_delegation_fee – bayaran untuk saiz pesanan yang terlalu kecil, TRX
resource_txs – tatasusunan yang mengandungi senarai transaksi dalam blockchain TRON di mana sumber diwakilkan dan ditebus guna (tidak diwakilkan)
status – status pesanan, nilai yang mungkin diterangkan pada permulaan manual ini
payment_status – status pembayaran pesanan dalam sistem pembayaran (nilai yang mungkin bergantung pada sistem pembayaran)

Kaedah "order/list" – mendapatkan senarai pesanan

Mendapatkan senarai pesanan.

order/list – Contoh permintaan

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

order/list – Param permintaan

sort (rentetan, pilihan) – pengisihan entri, secara lalai "created_at|desc"
per_page (integer, pilihan) – hadkan bilangan penyertaan setiap respons
page (integer, pilihan) – nombor berurutan halaman respons
filter (tatasusunan arrays(objects), pilihan) – penapis penyertaan

order/list – Contoh respons

{
	"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 – Parameter respons

guid – GUID perintah
status – status tindak balas API

Kaedah "account/list" – penyenaraian akaun dalaman

Mendapatkan senarai akaun dalaman, termasuk jumlah dana yang tersedia pada masa ini. Oleh kerana terdapat akaun dalaman yang berasingan untuk setiap bahagian laman web (buyer, affiliate, seller, dealer), terdapat beberapa akaun dalam akaun.

account/list – Contoh permintaan

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

account/list – Contoh respons

{
	"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 – Parameter respons

guid – GUID akaun dalaman
id – ID berjujukan akaun dalaman
section – bahagian EnergyFather yang mana baki ini tergolong
balance – dana yang tersedia
currency – mata wang
user_id – GUID pengguna

Kaedah "account/get/{id}" – mendapatkan akaun dalaman yang tepat

Mendapatkan baki akaun dalaman untuk bahagian tertentu EnergyFather. Oleh kerana setiap bahagian mempunyai akaun sendiri (buyer, affiliate, seller, dealer), terdapat beberapa akaun untuk setiap pengguna. Anda boleh menggunakan kaedah "account/list" terlebih dahulu untuk mendapatkan senarai mereka, mengetahui ‘id’ akaun yang diminati, dan kemudian gunakan ‘id’ ini untuk mendapatkan baki akaun tertentu.

account/get/{id} – Contoh permintaan

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

account/get/{id} – Contoh respons

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

account/get/{id} – Parameter respons

guid – GUID akaun dalaman
id - ID berurutan akaun dalaman
section - bahagian EnergyFather mana yang tergolong dalam baki ini
balance - dana yang ada
currency - mata wang
user_id - GUID pengguna