API dogfennaeth - EnergyFather.com

Mae'r EnergyFather gwasanaeth yn helpu i brynu (rhentu) yr egni a'r lled band sydd eu hangen i anfon trafodion i mewn USDT a thocynnau crypto eraill TRC20; Mae angen lled band hefyd i anfon unrhyw fath o drafodiad ar y TRON blockchain, megis anfon TRX, hawlio gwobrau, a phleidleisio ar gyfer Super Representatives.

Gweithdrefn prynu ynni

I brynu ynni, mae angen i chi gofrestru yn y EnergyFather gwasanaeth, bachu'r tocyn awdurdodi o'r dudalen "Tocynnau > API Prynwr", ac ychwanegu balans cyfrif y Prynwr.

Ar ôl creu gorchymyn (dull ‘buy/energy’) gellir cyflwyno ynni gydag oedi o sawl eiliad neu hyd yn oed funudau, felly wrth ddatblygu systemau awtomataidd argymhellir gwirio'r gweithredu gorchymyn o bryd i'w gilydd trwy ofyn am ddull ‘order/get/{guid}’.

Er enghraifft, os ydych chi'n bwriadu anfon USDT ac yn dymuno gwneud trafodion yn rhatach trwy brynu ynni, rydych chi'n gwneud y canlynol:

gofyn am y ‘buy/energy’ dull i amcangyfrif angen swm ynni a'i brynu,
Dull gwneud cais ‘order/get/{guid}’ o bryd i'w gilydd nes bod egni yn cael ei ddirprwyo (fel arfer mae'n cymryd ychydig eiliadau),
anfon USDT (bydd yr ynni a brynwyd yn cael ei ddefnyddio i dalu'r ffi trafodiad).

Nodiadau cyffredinol

Yn y ddogfennaeth hon, mae ymadrodd wedi'i lapio i mewn i freichiau cyrlio fel ‘{guid}’ neu'n ‘{id}’ golygu gwerth y newidyn cyfatebol:

‘{guid}’ yw dynodwr byd-eang unigryw y gwrthrych yn EnergyFather (8 digid fel arfer),
‘{id}’ yw rhif dilyniannol y gwrthrych ar gyfer y defnyddiwr hwn (mae rhifo yn dechrau gyda ‘1’ ar gyfer pob defnyddiwr).

API Diwedd y pwynt

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

Anfonwch geisiadau gan ddefnyddio'r POST dull.

Awdurdodi ceisiadau

I gadarnhau (awdurdodi) ceisiadau i breifat API, HTTP dylid pasio pennawd:

Token: {token}

Rheoli tocynnau awdurdodi wedi ei leoli yn y panel rheoli, ar y dudalen "Prynwr > API tocynnau".

Er enghraifft, gallwch gael gwybodaeth am orchymyn 123456 yn y ffordd ganlynol:

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

Statws gorchymyn

"0" -Hyd nes. Mae'r gorchymyn newydd gael ei greu.
"1" - Aros am y taliad. Mae'r ddolen dalu eisoes wedi'i chynhyrchu, EnergyFather yn aros am alwad yn ôl o'r system dalu. Ni ddefnyddir y statws hwn os yw'r gorchymyn yn cael ei dalu'n gyfan gwbl gan arian sydd ar gael yn y cyfrif mewnol.
"2" - Mae trefn dirprwyo ynni yn parhau.
"3" -Dirprwyedig. Mae egni yn cael ei roi allan.
"4" - Adferwyd (Dilelegated). Mae ynni'n cael ei dynnu'n ôl oherwydd diwedd y cyfnod amser cyflogedig.
"5" -Talu. Mae'r gorchymyn yn cael ei dalu a'i ychwanegu yn y ciw ar gyfer cyflenwi ynni.
"6" -Gwall.

Mae'r dilyniant arferol o statws: 0, 5, 2, 3, 4 . .

API dulliau

/api/v1/private/buy/energy - prynu ynni (wedi'i dalu o gyfrif mewnol)
/api/v1/private/order/list - cael rhestr o'ch archebion
/api/v1/private/order/get/{guid} - cael gwybodaeth am eich archeb
/api/v1/private/account/list - cael rhestr o'ch cyfrifon mewnol
/api/v1/private/account/get/{id} - cael gwybodaeth am eich cyfrif mewnol

Y "buy/energy" dull - prynu ynni (talwyd o gyfrif mewnol)

Cais i brynu ynni gan gwsmer cofrestredig gyda debyd o'r cyfrif mewnol. Mae'r egni yn cael ei anfon yn syth i'r cyfeiriad penodedig.

Os nad oes gan y cyfrif mewnol ddigon o arian, bydd y gorchymyn yn cael ei greu ac yn cael statws "6" ar unwaith (Error). Yn yr achos hwn, mae angen i chi ymweld â'r panel, adneuo rhywfaint o arian ac yna anfon cais newydd API am brynu ynni.

Mae dwy ffordd o ddiffinio faint o ynni i'w brynu:

a) Efallai y byddwch yn gosod yr union swm ynni yn y "amount" paramedr, yna dylech hefyd osod amount_source="amount".

b) Os nad ydych chi'n gwybod faint o ynni sydd ei angen er mwyn i drafodiad ei anfon USDT neu docyn arall, gallwch osod amount_source="estimate" a llenwi'r paramedrau (estimate_to, estimate_token, estimate_adjust_percent) priodol.

buy/energy : Cais enghreifftiol gydag union faint o ynni

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 : Enghraifft o gais gyda chyfrifo swm angenrheidiol o ynni

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 : Gofyn am barams

to (llinynnol, gofynnol) - TRON cyfeiriad y mae'r egni i gael ei ddirprwyo iddo
period_amount (cyfanrif, gofynnol) - cyfnod amser i brynu ynni
period_type (llinynnol, gofynnol) - math o gyfnod o amser. Gwerthoedd posibl: days, hours .
format (llinynnol, dewisol) - fformat ymateb. Gwerthoedd posibl: json (default), xml .
amount_source (llinyn, gofynnol) - algorithm ar gyfer penderfynu faint o egni dirprwyedig. Os yw'r gwerth yn "amount", yna defnyddir gwerth y paramedr "amount". Os yw'r gwerth, "estimate" cyfrifir y swm gofynnol o ynni yn seiliedig ar y paramedrau estimate_to, estimate_token, estimate_adjust_percent. Gwerthoedd posibl: amount, estimate .
amount (cyfanrif, gofynnol os amount_source="amount" ) - faint o ynni i'w brynu. Mae'n cael ei anwybyddu os amount_source="estimate".
estimate_to (llinynnol, gofynnol os amount_source="estimate" ) - rhestr coma-wahanedig o TRON gyfeiriadau y bwriedir anfon trafodion symbolaidd iddynt
estimate_token (llinyn, yn ofynnol os amount_source="estimate") - y tocyn TRC20. Gwerthoedd posibl (yn sensitif i achos): USDT, USDD, USDJ, JST, TUSD, stUSDT, WTRX.
estimate_adjust_percent (degol, gofynnol os amount_source="estimate" ) - y swm gormodol o ynni a fynegir fel canran. Mae angen y gormodedd hwn i osgoi llosgi TRX, a all ddigwydd os oes gan y cyfeiriad yr union faint o egni angenrheidiol. Gwerth a argymhellir yw 0.04%.

Pwysig: Ar hyn o bryd, dim ond 6 cyfnod sy'n ddilys: 1 hour a 1, 3, 7, 15, 30 days

buy/energy:Ymateb

Mewn achos o lwyddiant, bydd yr ymateb yn cynnwys y gorchymyn GUID, gan y gallwch gael ei fanylion gwirioneddol yn ddiweddarach.

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

Os yw'r cais yn cynnwys amount_source="estimate" yna mae gan yr ymateb adran ychwanegol "estimate_task" . Er enghraifft:

{
	"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 : Paramedrau ymateb

guid - y drefn GUID
balance - arian sydd ar gael ar hyn o bryd yn y cyfrif mewnol, TRX
days - hyd y ddarpariaeth ynni mewn dyddiau, os "period_type=days"
hours - hyd y ddarpariaeth ynni mewn oriau, os "period_type=hours"
estimate_task - cyfrifiad (amcangyfrif) o ynni sydd ei angen i anfon TRC20 trafodion o un TRON cyfeiriad i'r rhestr o gyfeiriadau eraill TRON

Y "order/get/{guid}" dull - cael manylion y gorchymyn

Cael gwybodaeth am y gorchymyn penodol.

order/get/{guid} - Cais enghreifftiol

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

order/get/{guid} - Ymateb enghreifftiol

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

guid - y drefn GUID
balance - arian sydd ar gael ar hyn o bryd yn y cyfrif mewnol, TRX
days - hyd y ddarpariaeth ynni mewn dyddiau, os "period_type=days"
hours - hyd y ddarpariaeth ynni mewn oriau, os "period_type=hours"
to - TRX cyfeiriad lle mae ynni'n cael ei gyflenwi
energy_amount - maint ynni
order_cost - cost gorchymyn, TRX
order_cost_paid - swm a dalwyd eisoes, TRX (rhag ofn nad oes digon o arian yn y cyfrif mewnol bydd y swm hwn yn llai na "order_cost" )
address_activation_fee - swm y ffi ar gyfer activation y cyfeiriad cyrchfan, TRX
energy_delegation_fee - ffi am faint archeb rhy fach, TRX
resource_txs - Amrywiaeth sy'n cynnwys y rhestr o drafodion mewn TRON blockchain lle mae adnoddau'n cael eu dirprwyo a'u hadennill (heb ei elegated)
status - statws gorchymyn, gwerthoedd posibl yn cael eu disgrifio ar ddechrau'r llawlyfr hwn
payment_status - statws talu gorchymyn yn y system dalu (mae gwerthoedd posibl yn dibynnu ar y system dalu)

Y "order/list" dull - cael y rhestr o orchmynion

Cael y rhestr o orchmynion.

order/list - Cais enghreifftiol

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

order/list - Params cais

sort (llinynnol, dewisol) - didoli ceisiadau, yn ddiofyn "created_at|desc"
per_page (cyfanrif, dewisol) - cyfyngu ar nifer y ceisiadau fesul ymateb
page (cyfanrif, dewisol) - rhif dilyniannol y dudalen ymateb
filter (amrywiaeth o arrays(objects), dewisol) - hidlo cofnodion

order/list - Ymateb enghreifftiol

{
	"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 - Paramedrau ymateb

guid - GUID o'r gorchymyn
status - Statws API ymateb

Y "account/list" dull - rhestru cyfrifon mewnol

Cael rhestr o gyfrifon mewnol, gan gynnwys faint o arian sydd ar gael ar hyn o bryd. Gan fod cyfrif mewnol ar wahân ar gyfer pob adran o'r wefan (buyer, affiliate, seller, dealer), mae sawl cyfrif yn y cyfrif.

account/list - Cais enghreifftiol

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

account/list - Ymateb enghreifftiol

{
	"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 - Paramedrau ymateb

guid - GUID o'r cyfrif mewnol
id - dilyniannol ID y cyfrif mewnol
section - i ba adran y EnergyFather mae'r cydbwysedd hwn yn perthyn iddi
balance - arian sydd ar gael
currency -arian breiniol
user_id - GUID o'r defnyddiwr

Y "account/get/{id}" dull - cael yr union gyfrif mewnol

Cael cydbwysedd y cyfrif mewnol ar gyfer adran benodol o EnergyFather . Gan fod gan bob adran ei chyfrif (buyer, affiliate, seller, dealer) ei hun, mae sawl cyfrif ar gyfer pob defnyddiwr. Gallwch ddefnyddio'r "account/list" dull yn gyntaf i gael eu rhestr, darganfod cyfrif ‘id’ llog, ac yna defnyddio hyn ‘id’ i gael cydbwysedd cyfrif penodol.

account/get/{id} - Cais enghreifftiol

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

account/get/{id} - Ymateb enghreifftiol

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

account/get/{id} - Paramedrau ymateb

guid - GUID o'r cyfrif mewnol
id - ID dilyniannol y cyfrif mewnol
section - Pa EnergyFather adran y mae'r cydbwysedd hwn yn perthyn iddi
balance - arian sydd ar gael
currency -arian breiniol
user_id - GUID o'r defnyddiwr

Dulliau cyhoeddus API

Cael pris egni

Dyma'r dull API nad oes angen dilysiad arno, mewn geiriau eraill, dyna'r dull cyhoeddus.

Sylwch fod ganddo bwynt terfyn gwahanol nag arferion preifat: /api/v1/public yn lle /api/v1/private.

/api/v1/public/price - Enghraifft o gais

curl 'https://panel.energyfather.com/api/v1/public/price?resource=energy&period_type=hours&period_amount=1'

/api/v1/public/price - Paramedrau cais

resource - dewis o adnodd TRON; gwerthoedd dilys: energy
period_type - uned o gyfnod rhent; gwerthoedd dilys: hours, days
period_amount - hyd cyfnod rhent; gwerthoedd dilys: 1 hour a 1, 3, 7, 15, 30 days.

/api/v1/public/price - Enghraifft o ymateb

{
	"status": "ok",
	"data": {
		"price": 44,
		"unit": "SUN"
		"resource_type": "energy",
		"period_amount": 1,
		"period_type": "hours",
	}
}

/api/v1/public/price - Paramedrau ymateb

price - pris fesul 1 uned adnodd
unit - mae’r ymateb yn dangos y pris mewn unedau SUN; 1 TRX = 1,000,000 SUN, 1 SUN = 10^-6 TRX. Peidiwch â’i gymysgu â’r arian digidol SUN.
resource_type - dewis o adnodd TRON
period_type - uned o gyfnod rhentu
period_amount - hyd y cyfnod rhentu