API belgeleri

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 oylama yapmak 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çleri" 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 hatta dakika gecikmeyle teslim edilebilir, bu nedenle otomatik sistemler geliştirirken ‘order/get/{guid}’ yöntemini 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:

  • İhtiyaç duyulan 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),
  • USDT gönderin (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 global 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

Talepleri POST yöntemini kullanarak gönderin.

Taleplerin yetkilendirilmesi

Özel bir API'ye 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çleri" 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" - Devredildi. Enerji verilir.
  • "4" - Geri Alınmış (Devredilmemiş). Ücretli sürenin sona ermesi nedeniyle enerji geri çekilir.
  • "5" - Ödendi. Sipariş ödenir ve enerji teslimatı için sıraya eklenir.
  • "6" - Hata.

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

API yöntemleri
  • /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 yetersiz para varsa, sipariş oluşturulacak ve anında "6" (Hata) durumunu alacaktı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) USDT veya başka bir token göndermek için bir işlem için ne kadar enerji gerektiğini bilmiyorsanız, amount_source="estimate"'yı ayarlayabilir ve uygun (estimate_to, estimate_token, estimate_adjust_percent) parametrelerini 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 ilgili ö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) - Enerjinin devredileceği TRON adresi
  • 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ı. 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, adres tam olarak gerekli enerji miktarına sahipse meydana gelebilecek TRX yanmasını önlemek için gereklidir. Önerilen değer 0.04%.'dir

Önemli: Şu anda sadece 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ı alabileceğiniz GUID siparişini 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 "estimate_task" bölümü bulunur. Ö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 - GUID sırası
  • balance - şu anda dahili hesapta bulunan fonlar, TRX
  • days - "period_type=days" ise gün cinsinden enerji sağlama süresi
  • hours - "period_type=hours" ise saat cinsinden enerji sağlama süresi
  • estimate_task - TRC20 işlemlerini bir TRON adresinden başka bir TRON adresleri 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 - GUID sırası
  • balance - şu anda dahili hesapta bulunan fonlar, TRX
  • days - "period_type=days" ise gün cinsinden enerji sağlama süresi
  • hours - "period_type=hours" ise saat cinsinden enerji sağlama süresi
  • 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"'dan daha az olacaktır)
  • address_activation_fee - hedef adresin etkinleştirilmesi için ücret tutarı, 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 - Paramları iste

  • 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. (buyer, affiliate, seller, dealer) sitesinin her bölümü için ayrı bir dahili hesap olduğundan, 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'si
  • id - dahili hesabın sıralı ID'si
  • section - bu bakiyenin hangi EnergyFather bölümüne ait olduğu
  • balance - mevcut fonlar
  • currency - para birimi
  • Kullanıcının user_id - GUID

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

EnergyFather'nin belirli bir bölümü için dahili hesap bakiyesinin elde edilmesi. Her bölümün kendi (buyer, affiliate, seller, dealer) hesabı olduğundan, her kullanıcı için birkaç hesap vardır. Bunların listesini 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'si
  • id - dahili hesabın sıralı kimliği
  • section - bu bakiyenin hangi EnergyFather bölümüne ait olduğu
  • balance - mevcut fonlar
  • currency - para birimi
  • Kullanıcının user_id - GUID