API Dokumentasi

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

Prosedur pembelian tenaga

Untuk membeli tenaga, anda perlu mendaftar dalam EnergyFather perkhidmatan, ambil token kebenaran dari halaman "Token > API pembeli", 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, disyorkan untuk memeriksa 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:

  • meminta ‘buy/energy’ kaedah untuk menganggarkan jumlah tenaga yang diperlukan dan membelinya,
  • kaedah permintaan ‘order/get/{guid}’ secara berkala 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 POST kaedah.

Kebenaran permintaan

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

Token: {token}

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

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" -Diberikan. Tenaga diberikan.
  • "4" - Dituntut Semula (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 .

API Kaedah
  • /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 dari akaun dalaman)

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

Jika akaun dalaman mempunyai dana yang tidak 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 baru API untuk pembelian tenaga.

Terdapat dua cara untuk menentukan jumlah tenaga yang akan dibeli:

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

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

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

  • to (rentetan, diperlukan) – TRON alamat 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 adalah "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 yang TRON 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 perintah 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 "estimate_task" tambahan . 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 TRC20 transaksi dari satu TRON alamat ke senarai alamat lain TRON

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 – TRX alamat 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 TRON blockchain 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 pesanan
  • status – status tindak API balas

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 banyak 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 – urutan ID akaun dalaman
  • section – bahagian mana baki EnergyFather ini tergolong
  • balance – dana yang ada
  • currency –Mata wang
  • user_id – GUID daripada pengguna

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

Mendapatkan baki akaun dalaman untuk bahagian EnergyFather tertentu . Oleh kerana setiap bahagian mempunyai akaunnya (buyer, affiliate, seller, dealer) sendiri, terdapat beberapa akaun untuk setiap pengguna. Anda boleh menggunakan kaedah ini "account/list" terlebih dahulu untuk mendapatkan senarai mereka, mengetahui ‘id’ akaun yang diminati, dan kemudian menggunakannya ‘id’ 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 mana baki EnergyFather ini tergolong
  • balance - dana yang ada
  • currency -Mata wang
  • user_id - GUID daripada pengguna