API dogfennaeth

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, gofynnol os amount_source="estimate" ) – y TRC20 tocyn. Gwerthoedd posibl (sensitif i achosion): USDT, USDC, 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