API doiciméadú

Nós imeachta maidir le ceannach fuinnimh

Chun fuinneamh a cheannach, ní mór duit clárú sa EnergyFather tseirbhís, grab an comhartha údaraithe ón leathanach "Comharthaí > API Ceannaitheora", agus iarmhéid chuntas an Cheannaitheora a bhreisiú.

Tar éis a chruthú ordú (modh ‘buy/energy’) Is féidir fuinneamh a sheachadadh le moill ar roinnt soicind nó fiú nóiméad, mar sin nuair a fhorbairt córais uathoibrithe tá sé molta a sheiceáil go tréimhsiúil ar fhorghníomhú ordú trí mhodh ‘order/get/{guid}’ a iarraidh .

Mar shampla, má tá sé i gceist agat idirbhearta a sheoladh USDT agus más mian leat idirbhearta a dhéanamh níos saoire trí fhuinneamh a cheannach, déanann tú an méid seo a leanas:

• ‘buy/energy’ an modh a iarraidh chun an méid fuinnimh is gá a mheas agus é a cheannach,
• modh a iarraidh ‘order/get/{guid}’ go tréimhsiúil go dtí go dtarmligtear fuinneamh (de ghnáth tógann sé cúpla soicind),
• (USDT úsáidfear an fuinneamh ceannaithe chun an táille idirbhirt a íoc).

Nótaí ginearálta

Sa doiciméadú seo, slonn fillte i braces curly cosúil le ‘{guid}’ nó ‘{id}’ ciallaíonn sé luach na hathróige comhfhreagrach:

• ‘{guid}’ aitheantóir uathúil domhanda an réada in EnergyFather (8 ndigit de ghnáth),
• ‘{id}’ is é uimhir sheicheamhach an réada don úsáideoir seo (tosaíonn an t-uimhriú le ‘1’ gach úsáideoir).

API Críochphointe

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

Seol iarratais ag baint úsáide as an POST modh.

Iarrataí a údarú

Chun iarratais ar phríobháideach API a dhearbhú (údarú) ba chóir ceanntásc HTTP a rith:

Token: {token}

Tá bainistíocht comharthaí údaraithe suite sa phainéal rialaithe, ar an leathanach "Comharthaí > API Ceannaitheora".

Mar shampla, is féidir leat faisnéis a fháil faoi ordú 123456 ar an mbealach seo a leanas:

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

Stádas ordaithe

• "0" - Ar feitheamh. Tá an t-ordú díreach cruthaithe.
• "1" - Ag fanacht leis an íocaíocht. Gineadh an nasc íocaíochta cheana féin, EnergyFather ag fanacht le aisghlaoch ón gcóras íocaíochta. Ní úsáidtear an stádas seo má íoctar an t-ordú go hiomlán le cistí atá ar fáil ag an gcuntas inmheánach.
• "2" - Tá nós imeachta tarmligin fuinnimh ar siúl faoi láthair.
• "3" - Tarmligthe. Tugtar fuinneamh amach.
• "4" - Athéileamh (neamh-tharmligthe). Tarraingítear siar fuinneamh mar gheall ar dheireadh na tréimhse ama íoctha.
• "5" - Íoctha. Íoctar an t-ordú agus cuirtear isteach sa scuaine é chun fuinneamh a sheachadadh.
• "6" - Earráid.

An t-ord is gnách de statuses: 0, 5, 2, 3, 4 .

An "buy/energy" modh – fuinneamh a cheannach (íoctha ó chuntas inmheánach)

Iarratas ar fhuinneamh a cheannach ag custaiméir cláraithe le dochar ón gcuntas inmheánach. Seoltar an fuinneamh láithreach chuig an seoladh sonraithe.

Mura bhfuil dóthain airgid ag an gcuntas inmheánach, cruthófar an t-ordú agus gheobhaidh sé stádas "6" láithreach (Earráid). Sa chás seo ní mór duit cuairt a thabhairt ar an bpainéal, roinnt cistí a thaisceadh agus ansin iarratas nua API ar cheannach fuinnimh a sheoladh.

Tá dhá bhealach ann chun an méid fuinnimh atá le ceannach a shainiú:

a) Is féidir leat a leagtar ar an méid fuinnimh cruinn sa "amount" pharaiméadar, ansin ba chóir duit a leagtar amount_source="amount" freisin .

b) Mura bhfuil a fhios agat cé mhéad fuinnimh atá ag teastáil le haghaidh idirbheart a sheoladh USDT nó comhartha eile, is féidir leat a shocrú amount_source="estimate" agus a líonadh isteach na paraiméadair (estimate_to, estimate_token, estimate_adjust_percent) cuí .

buy/energy : Iarratas samplach le méid cruinn fuinnimh

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 : Iarratas samplach le ríomh an méid fuinnimh is gá

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 a iarraidh

• to (teaghrán, riachtanach) – TRON seoladh a bhfuil an fuinneamh le tarmligean chuige
• period_amount (slánuimhir, riachtanach) – tréimhse ama chun fuinneamh a cheannach
• period_type (teaghrán, riachtanach) – cineál tréimhse ama. Luachanna féideartha: days, hours .
• format (teaghrán, roghnach) – formáid freagartha. Luachanna féideartha: json (default), xml .
• amount_source (teaghrán, riachtanach) – algartam chun méid an fhuinnimh tharmligthe a chinneadh. Má tá "amount" an luach, ansin tá an luach an paraiméadar "amount" a úsáidtear. Má tá "estimate" an luach, tá an méid is gá fuinnimh a ríomh bunaithe ar na paraiméadair estimate_to, estimate_token, estimate_adjust_percent . Luachanna féideartha: amount, estimate .
• amount (slánuimhir, ag teastáil más rud é amount_source="amount" ) – méid an fhuinnimh atá le ceannach. Déantar neamhaird de más rud amount_source="estimate" é .
• estimate_to (teaghrán, ag teastáil más rud é amount_source="estimate" ) – liosta camóg-scartha de TRON sheoltaí a bhfuil sé beartaithe idirbhearta comhartha a sheoladh chucu
• estimate_token (teaghrán, ag teastáil más rud é amount_source="estimate" ) – an TRC20 comhartha. Luachanna féideartha (cásíogair): USDT, USDC, USDD, USDJ, JST, TUSD, stUSDT, WTRX .
• estimate_adjust_percent (deachúil, ag teastáil más rud é amount_source="estimate" ) – an méid fuinnimh barrachais arna shloinneadh mar chéatadán. Tá an farasbarr seo ag teastáil chun dó TRX a sheachaint, rud a d'fhéadfadh tarlú má tá an méid fuinnimh is gá ag an seoladh. Is é an luach molta ná 0.04%.

Tábhachtach: Faoi láthair, níl ach 6 thréimhse bailí: 1 hour agus 1, 3, 7, 15, 30 days .

buy/energy : Freagra

I gcás ratha, beidh an t-ordú GUID sa fhreagra, trínar féidir leat a chuid sonraí iarbhír a fháil níos déanaí.

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

Má tá iarratas ansin amount_source="estimate" tá an freagra alt "estimate_task" breise. Mar shampla:

{
	"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 : Paraimí freagartha

• guid - an t-ordú GUID
• balance – cistí atá ar fáil faoi láthair sa chuntas inmheánach, TRX
• days – fad an tsoláthair fuinnimh i laethanta, más rud é "period_type=days"
• hours – fad an tsoláthair fuinnimh in uaireanta, más rud é "period_type=hours"
• estimate_task – ríomh (meastachán) an fhuinnimh is gá chun idirbhearta a sheoladh TRC20 ó sheoladh amháin TRON chuig liosta seoltaí eile TRON

An "order/get/{guid}" modh - ag fáil sonraí an ordaithe

Faisnéis a fháil faoin ordú sonrach.

order/get/{guid} - Iarratas samplach

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

order/get/{guid} - Freagra samplach

{
	"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} - Paraimí freagartha

• guid - an t-ordú GUID
• balance – cistí atá ar fáil faoi láthair sa chuntas inmheánach, TRX
• days – fad an tsoláthair fuinnimh i laethanta, más rud é "period_type=days"
• hours – fad an tsoláthair fuinnimh in uaireanta, más rud é "period_type=hours"
• to – aghaidh a TRX thabhairt ar an áit a seachadtar fuinneamh
• energy_amount – cainníocht fuinnimh
• order_cost – costas ordaithe, TRX
• order_cost_paid – an méid a íocadh cheana féin, TRX (i gcás nach leor cistí sa chuntas inmheánach, beidh an méid sin níos lú ná "order_cost" )
• address_activation_fee – méid na táille chun an seoladh cinn scríbe a ghníomhachtú, TRX
• energy_delegation_fee – táille ar mhéid ordú ró-bheag, TRX
• resource_txs – eagar ina bhfuil liosta na n-idirbheart i TRON mblocshlabhra ina ndéantar acmhainní a tharmligean agus a athshlánú (gan tarmligean)
• status – stádas ordú, déantar cur síos ar luachanna féideartha ag tús an lámhleabhair seo
• payment_status – stádas íocaíochta ordú sa chóras íocaíochta (braitheann luachanna féideartha ar an gcóras íocaíochta)

An "order/list" modh - ag fáil an liosta na n-orduithe

Liosta na n-orduithe a fháil.

order/list - Iarratas samplach

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

order/list - Params a iarraidh

• sort (teaghrán, roghnach) – sórtáil iontrálacha, de réir réamhshocraithe "created_at|desc"
• per_page (slánuimhir, roghnach) – teorainn a chur le líon na n-iontrálacha in aghaidh an fhreagra
• page (slánuimhir, roghnach) – uimhir sheicheamhach an leathanaigh freagartha
• filter (sraith de arrays(objects), roghnach) – scagaire na n-iontrálacha

order/list - Freagra samplach

{
	"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 - Paraimí freagartha

• guid - GUID an ordaithe
• status – stádas na API freagartha

An "account/list" modh – liostú na gcuntas inmheánach

Liosta cuntas inmheánach a fháil, lena n-áirítear an méid cistí atá ar fáil faoi láthair. Ós rud é go bhfuil cuntas inmheánach ar leith ann do gach cuid den suíomh (buyer, affiliate, seller, dealer), tá cuntais iolracha sa chuntas.

account/list - Iarratas samplach

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

account/list - Freagra samplach

{
	"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 – Paraimí freagartha

• guid – GUID an chuntais inmheánaigh
• id – seicheamhach ID an chuntais inmheánaigh
• section – cén roinn lena EnergyFather mbaineann an t-iarmhéid seo
• balance – cistí atá ar fáil
• currency – airgeadra
• user_id – GUID an úsáideora

An "account/get/{id}" modh - ag fáil an cuntas inmheánach cruinn

Iarmhéid an chuntais inmheánaigh a fháil do chuid ar leith de EnergyFather . Ós rud é go bhfuil a chuntas (buyer, affiliate, seller, dealer) féin ag gach rannóg, tá roinnt cuntas ann do gach úsáideoir. Is féidir leat an "account/list" modh a úsáid ar dtús chun a liosta a fháil, an cuntas úis a fháil amach ‘id’, agus ansin é seo ‘id’ a úsáid chun iarmhéid cuntais áirithe a fháil.

account/get/{id} - Iarratas samplach

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

account/get/{id} - Freagra samplach

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

account/get/{id} - Paraimí freagartha

• guid – GUID an chuntais inmheánaigh
• id - aitheantas seicheamhach an chuntais inmheánaigh
• section - cén chuid lena EnergyFather mbaineann an t-iarmhéid seo
• balance - cistí atá ar fáil
• currency - airgeadra
• user_id - GUID an úsáideora