API dokümantasyon - EnergyFather.com

EnergyFather hizmeti, USDT ve diğer TRC20 kripto jetonlarında işlem göndermek için gereken enerji ve bant genişliğini satın almaya (kiralamaya) yardımcı olur; TRON blok zincirinde TRX göndermek, ödül talep etmek ve Super Representatives için oy kullanmak gibi her türlü işlemi göndermek için de bant genişliğine ihtiyaç vardır.

Enerji satın alma prosedürü

Enerji satın almak için EnergyFather hizmetine kaydolmanız, "Alıcı > API belirteçler" sayfasından yetkilendirme belirtecini almanız ve Alıcı hesap bakiyesini doldurmanız gerekir.

Bir emir oluşturduktan sonra (yöntem ‘buy/energy’) enerji birkaç saniye veya hatta dakika gecikmeyle teslim edilebilir, bu nedenle otomatik sistemler geliştirirken yöntem ‘order/get/{guid}’ talep ederek emrin yürütülmesini periyodik olarak kontrol etmeniz önerilir.

Örneğin, USDT göndermeyi planlıyorsanız ve enerji satın alarak işlemleri daha ucuza getirmek istiyorsanız, aşağıdakileri yaparsınız:

gerekli enerji miktarını tahmin etmek ve satın almak için ‘buy/energy’ yöntemini talep edin,
enerji devredilene kadar periyodik olarak ‘order/get/{guid}’ yöntemini talep eder (genellikle birkaç saniye sürer),
gönderin USDT (satın alınan enerji işlem ücretini ödemek için kullanılacaktır).

Genel notlar

Bu belgede, ‘{guid}’ veya ‘{id}’ gibi küme parantezleri içine alınmış bir ifade, ilgili değişkenin değeri anlamına gelir:

‘{guid}’, EnergyFather'deki nesnenin küresel benzersiz tanımlayıcısıdır (genellikle 8 basamaklı),
‘{id}’ bu kullanıcı için nesnenin sıralı numarasıdır (numaralandırma her kullanıcı için ‘1’ ile başlar).

API Son nokta

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

İstekleri POST yöntemini kullanarak gönderin.

Taleplerin yetkilendirilmesi

Özel bir API'e yapılan istekleri onaylamak (yetkilendirmek) için bir HTTP başlığı geçirilmelidir:

Token: {token}

Yetkilendirme belirteçlerinin yönetimi kontrol panelinde, "Alıcı > API belirteçler" sayfasında bulunur.

Örneğin, 123456 numaralı sipariş hakkında aşağıdaki şekilde bilgi alabilirsiniz:

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

Sipariş durumu

"0" - Beklemede. Sipariş henüz oluşturuldu.
"1" - Ödeme bekleniyor. Ödeme bağlantısı zaten oluşturuldu, EnergyFather ödeme sisteminden bir geri arama bekliyor. Sipariş tamamen dahili hesapta bulunan fonlarla ödeniyorsa bu durum kullanılmaz.
"2" - Enerji delegasyonu prosedürü devam etmektedir.
"3" - Devredilir. Enerji dışarı verilir.
"4" - Geri Kazanılmış (Devredilmemiş). Enerji, ödenen sürenin sona ermesi nedeniyle geri çekilir.
"5" - Ödendi. Sipariş ödenir ve enerji teslimatı için kuyruğa eklenir.
"6" - Hata.

Olağan durum sıralaması: 0, 5, 2, 3, 4.

API yöntemler

/api/v1/private/buy/energy - enerji satın alın (dahili hesaptan ödenir)
/api/v1/private/order/list - siparişlerinizin bir listesini alın
/api/v1/private/order/get/{guid} - siparişiniz hakkında bilgi alın
/api/v1/private/account/list - dahili hesaplarınızın bir listesini alın
/api/v1/private/account/get/{id} - dahili hesabınız hakkında bilgi alın

"buy/energy" yöntemi - enerji satın alın (dahili hesaptan ödenir)

Kayıtlı bir müşteri tarafından iç hesaptan borçlandırma ile enerji satın alma talebi. Enerji hemen belirtilen adrese gönderilir.

Dahili hesapta yeterli para yoksa, sipariş oluşturulur ve anında "6" (Hata) durumunu alır. Bu durumda paneli ziyaret etmeniz, bir miktar para yatırmanız ve ardından enerji satın almak için yeni bir API talebi göndermeniz gerekir.

Satın alınacak enerji miktarını tanımlamanın iki yolu vardır:

a) "amount" parametresinde tam enerji miktarını ayarlayabilirsiniz, o zaman amount_source="amount"'yi de ayarlamalısınız.

b) Bir işlemin USDT veya başka bir token göndermesi için ne kadar enerji gerektiğini bilmiyorsanız, amount_source="estimate" ayarlayabilir ve uygun parametreleri (estimate_to, estimate_token, estimate_adjust_percent) doldurabilirsiniz.

buy/energy: Tam enerji miktarı ile örnek talep

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: İhtiyaç duyulan enerji miktarının hesaplanması ile örnek talep

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: İstek parametreleri

to (dize, gerekli) - TRON enerjinin devredileceği adres
period_amount (tamsayı, gerekli) - enerji satın alınacak süre
period_type (dize, gerekli) - zaman periyodu türü. Olası değerler: days, hours.
format (dize, isteğe bağlı) - yanıt biçimi. Olası değerler: json (default), xml.
amount_source (dize, gerekli) - devredilen enerji miktarını belirleme algoritması. Değer "amount" ise, "amount" parametresinin değeri kullanılır. Değer "estimate" ise, gerekli enerji miktarı estimate_to, estimate_token, estimate_adjust_percent parametrelerine göre hesaplanır. Olası değerler: amount, estimate.
amount (tamsayı, amount_source="amount" ise gereklidir) - satın alınacak enerji miktarı. Eğer amount_source="estimate" ise göz ardı edilir.
estimate_to (string, required if amount_source="estimate") - token işlemlerinin gönderilmesi planlanan TRON adreslerinin virgülle ayrılmış listesi
estimate_token (dize, amount_source="estimate" ise gereklidir) - TRC20 belirteci. Olası değerler (büyük/küçük harfe duyarlı): USDT, USDC, USDD, USDJ, JST, TUSD, stUSDT, WTRX.
estimate_adjust_percent (ondalık, amount_source="estimate" ise gereklidir) - yüzde olarak ifade edilen fazla enerji miktarı. Bu fazlalık, adresin tam olarak gerekli miktarda enerjiye sahip olması durumunda meydana gelebilecek TRX yanmasını önlemek için gereklidir. Önerilen değer 0.04%.

Önemli: Şu anda yalnızca 6 dönem geçerlidir: 1 hour ve 1, 3, 7, 15, 30 days.

buy/energy: Yanıt

Başarılı olması durumunda, yanıt daha sonra gerçek ayrıntılarını elde edebileceğiniz sipariş GUID içerecektir.

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

İstek amount_source="estimate" içeriyorsa, yanıtta ek bir bölüm "estimate_task" vardır. Örneğin:

{
	"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: Yanıt parametreleri

guid - sipariş GUID
balance - iç hesapta halihazırda mevcut olan fonlar, TRX
days - gün cinsinden enerji sağlama süresi, eğer "period_type=days"
hours - saat cinsinden enerji sağlama süresi, eğer "period_type=hours"
estimate_task - TRC20 işlemlerini bir TRON adresten başka bir TRON adres listesine göndermek için gereken enerjinin hesaplanması (tahmini)

"order/get/{guid}" yöntemi - siparişin ayrıntılarını alma

Belirli bir sipariş hakkında bilgi edinme.

order/get/{guid} - Örnek talep

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

order/get/{guid} - Örnek yanıt

{
	"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} - Yanıt parametreleri

guid - sipariş GUID
balance - iç hesapta halihazırda mevcut olan fonlar, TRX
days - gün cinsinden enerji sağlama süresi, eğer "period_type=days"
hours - saat cinsinden enerji sağlama süresi, eğer "period_type=hours"
to - TRX enerjinin teslim edildiği adres
energy_amount - enerji miktarı
order_cost - sipariş maliyeti, TRX
order_cost_paid - halihazırda ödenmiş tutar, TRX (dahili hesapta yetersiz fon olması durumunda bu tutar "order_cost"'den az olacaktır)
address_activation_fee - hedef adresin etkinleştirilmesi için ücret miktarı, TRX
energy_delegation_fee - çok küçük sipariş boyutu için ücret, TRX
resource_txs - TRON blok zincirinde kaynakların devredildiği ve geri alındığı (devredilmemiş) işlemlerin listesini içeren dizi
status - sipariş durumu, olası değerler bu kılavuzun başında açıklanmıştır
payment_status - ödeme sistemindeki sipariş ödeme durumu (olası değerler ödeme sistemine bağlıdır)

"order/list" yöntemi - siparişlerin listesini alma

Sipariş listesi alınıyor.

order/list - Örnek talep

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

order/list - İstek parametreleri

sort (dize, isteğe bağlı) - girişlerin sıralanması, varsayılan olarak "created_at|desc"
per_page (tamsayı, isteğe bağlı) - yanıt başına giriş sayısını sınırlar
page (tamsayı, isteğe bağlı) - yanıt sayfasının sıralı numarası
filter (arrays(objects) dizisi, isteğe bağlı) - girişlerin filtresi

order/list - Örnek yanıt

{
	"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 - Yanıt parametreleri

guid - Siparişin GUID'si
status - API yanıtının durumu

"account/list" yöntemi - iç hesapların listelenmesi

Şu anda mevcut olan fon miktarı da dahil olmak üzere dahili hesapların bir listesini alma. Sitenin her bölümü için ayrı bir dahili hesap olduğundan (buyer, affiliate, seller, dealer), hesapta birden fazla hesap vardır.

account/list - Örnek talep

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

account/list - Örnek yanıt

{
	"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 - Yanıt parametreleri

guid - Dahili hesabın GUID'i
id - iç hesabın sıralı ID'si
section - bu bakiyenin hangi EnergyFather bölüme ait olduğu
balance - mevcut fonlar
currency - para birimi
user_id - Kullanıcının GUID

"account/get/{id}" yöntemi - tam dahili hesabı elde etme

Belirli bir EnergyFather bölümü için dahili hesabın bakiyesini elde etme. Her bölümün kendi hesabı (buyer, affiliate, seller, dealer) olduğundan, her kullanıcı için birkaç hesap vardır. Listelerini almak için önce "account/list" yöntemini kullanabilir, ilgilenilen hesabın ‘id’'sini bulabilir ve ardından belirli bir hesabın bakiyesini almak için bu ‘id’'yi kullanabilirsiniz.

account/get/{id} - Örnek talep

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

account/get/{id} - Örnek yanıt

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

account/get/{id} - Yanıt parametreleri

guid - Dahili hesabın GUID'i
id - dahili hesabın sıralı kimliği
section - bu bakiyenin hangi EnergyFather bölüme ait olduğu
balance - mevcut fonlar
currency - para birimi
user_id - Kullanıcının GUID