API tư liệu - EnergyFather.com

Dịch vụ này EnergyFather giúp mua (thuê) năng lượng và băng thông cần thiết để gửi các giao dịch trong USDT và các mã thông báo tiền điện tử khác TRC20; Băng thông cũng cần thiết để gửi bất kỳ loại giao dịch nào trên TRON blockchain, chẳng hạn như gửi TRX, nhận phần thưởng và bỏ phiếu cho Super Representatives .

Thủ tục mua năng lượng

Để mua năng lượng, bạn cần đăng ký EnergyFather dịch vụ, lấy mã thông báo ủy quyền từ trang "Người mua > API mã thông báo" và nạp tiền vào số dư tài khoản Người mua.

Sau khi tạo đơn hàng (phương thức ‘buy/energy’), năng lượng có thể được phân phối với độ trễ vài giây hoặc thậm chí vài phút, vì vậy khi phát triển hệ thống tự động, nên kiểm tra định kỳ việc thực hiện lệnh bằng phương thức ‘order/get/{guid}’ yêu cầu.

Ví dụ: nếu bạn dự định gửi USDT và muốn thực hiện giao dịch rẻ hơn bằng cách mua năng lượng, bạn làm như sau:

yêu cầu phương ‘buy/energy’ pháp ước tính lượng năng lượng cần thiết và mua nó,
định kỳ yêu cầu ‘order/get/{guid}’ phương pháp cho đến khi năng lượng được ủy quyền (thường mất vài giây),
gửi USDT (năng lượng mua sẽ được sử dụng để thanh toán phí giao dịch).

Ghi chú chung

Trong tài liệu này, một biểu thức được bọc trong dấu ngoặc nhọn như ‘{guid}’ hoặc ‘{id}’ có nghĩa là giá trị của biến tương ứng:

‘{guid}’ là mã định danh duy nhất toàn cục của đối tượng trong EnergyFather (thường là 8 chữ số),
‘{id}’ là số tuần tự của đối tượng cho người dùng này (đánh số bắt đầu bằng ‘1’ cho mỗi người dùng).

API Điểm cuối

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

Thực hiện gửi yêu cầu bằng phương POST thức.

Ủy quyền yêu cầu

Để xác nhận (ủy quyền) các yêu cầu cho riêng tư API, một HTTP tiêu đề phải được thông qua:

Token: {token}

Quản lý mã thông báo ủy quyền được đặt trong bảng điều khiển, trên trang "Người mua > API mã thông báo".

Ví dụ: bạn có thể nhận thông tin về 123456 đặt hàng theo cách sau:

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

Trạng thái đơn hàng

"0" -Chờ. Đơn đặt hàng vừa được tạo.
"1" - Đang chờ thanh toán. Liên kết thanh toán đã được tạo, EnergyFather đang chờ gọi lại từ hệ thống thanh toán. Trạng thái này không được sử dụng nếu đơn đặt hàng được thanh toán hoàn toàn bằng tiền có sẵn tại tài khoản nội bộ.
"2" - Thủ tục ủy quyền năng lượng đang diễn ra.
"3" -Giao. Năng lượng được đưa ra.
"4" - Khai hoang (Không ủy quyền). Năng lượng bị rút do kết thúc khoảng thời gian được thanh toán.
"5" -Trả tiền. Đơn hàng được thanh toán và thêm vào hàng đợi để giao năng lượng.
"6" -Lỗi.

Trình tự trạng thái thông thường: 0, 5, 2, 3, 4 .

API Phương pháp

/api/v1/private/buy/energy – Mua năng lượng (thanh toán từ tài khoản nội bộ)
/api/v1/private/order/list – Nhận danh sách các đơn đặt hàng của bạn
/api/v1/private/order/get/{guid} – Nhận thông tin về đơn đặt hàng của bạn
/api/v1/private/account/list – Nhận danh sách các tài khoản nội bộ của bạn
/api/v1/private/account/get/{id} – Nhận thông tin về tài khoản nội bộ của bạn

Phương "buy/energy" thức – mua năng lượng (thanh toán từ tài khoản nội bộ)

Yêu cầu mua năng lượng của khách hàng đã đăng ký bằng ghi nợ từ tài khoản nội bộ. Năng lượng ngay lập tức được gửi đến địa chỉ được chỉ định.

Nếu tài khoản nội bộ không có đủ tiền, lệnh sẽ được tạo và ngay lập tức có trạng thái "6" (Lỗi). Trong trường hợp này, bạn cần truy cập bảng điều khiển, gửi một số tiền và sau đó gửi yêu cầu mua năng lượng mới API.

Có hai cách để xác định lượng năng lượng cần mua:

a) Bạn có thể đặt lượng năng lượng chính xác trong "amount" tham số, sau đó bạn cũng nên đặt amount_source="amount" .

b) Nếu bạn không biết cần bao nhiêu năng lượng cho một giao dịch để gửi USDT hoặc một mã thông báo khác, bạn có thể đặt amount_source="estimate" và điền vào các thông số (estimate_to, estimate_token, estimate_adjust_percent) thích hợp.

buy/energy : Yêu cầu ví dụ với lượng năng lượng chính xác

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 : Yêu cầu ví dụ với tính toán lượng năng lượng cần thiết

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 : Yêu cầu params

to (chuỗi, bắt buộc) - TRON địa chỉ mà năng lượng sẽ được ủy quyền
period_amount (số nguyên, bắt buộc) - khoảng thời gian để mua năng lượng
period_type (chuỗi, bắt buộc) - loại khoảng thời gian. Giá trị có thể: days, hours .
format (chuỗi, tùy chọn) - định dạng phản hồi. Giá trị có thể: json (default), xml .
amount_source (chuỗi, bắt buộc) – thuật toán để xác định lượng năng lượng được ủy quyền. Nếu giá trị là "amount", thì giá trị của tham số "amount" được sử dụng. Nếu giá trị là "estimate", lượng năng lượng cần thiết được tính toán dựa trên các tham số estimate_to, estimate_token, estimate_adjust_percent. Giá trị có thể: amount, estimate .
amount (số nguyên, bắt buộc nếu amount_source="amount") – lượng năng lượng cần mua. Nó bị bỏ qua nếu amount_source="estimate" .
estimate_to (chuỗi, bắt buộc nếu amount_source="estimate") - danh sách TRON các địa chỉ được phân tách bằng dấu phẩy mà các giao dịch mã thông báo được lên kế hoạch gửi đến
estimate_token (chuỗi, bắt buộc nếu amount_source="estimate") – mã TRC20 thông báo. Các giá trị có thể có (phân biệt chữ hoa chữ thường): USDT, USDC, USDD, USDJ, JST, TUSD, stUSDT, WTRX .
estimate_adjust_percent (thập phân, bắt buộc nếu amount_source="estimate") - lượng năng lượng dư thừa được biểu thị bằng tỷ lệ phần trăm. Sự dư thừa này là cần thiết để tránh đốt cháy TRX, điều này có thể xảy ra nếu địa chỉ có chính xác lượng năng lượng cần thiết. Giá trị được đề xuất là 0.04%.

Quan trọng: Hiện tại, chỉ có 6 khoảng thời gian hợp lệ: 1 hour và 1, 3, 7, 15, 30 days .

buy/energy:Phản ứng

Trong trường hợp thành công, phản hồi sẽ chứa thứ tự GUID, qua đó sau này bạn có thể có được chi tiết thực tế của nó.

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

Nếu request chứa amount_source="estimate" thì response có phần bổ sung "estimate_task". Chẳng hạn:

{
	"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 : Tham số phản hồi

guid – Thứ tự GUID
balance – tiền hiện có sẵn trong tài khoản nội bộ, TRX
days – Thời gian cung cấp năng lượng tính bằng ngày, nếu "period_type=days"
hours – Thời gian cung cấp năng lượng tính bằng giờ, nếu "period_type=hours"
estimate_task – Tính toán (ước tính) năng lượng cần thiết để gửi TRC20 các giao dịch từ một TRON địa chỉ đến danh sách các địa chỉ khác TRON

Phương "order/get/{guid}" pháp – nhận thông tin chi tiết về đơn đặt hàng

Lấy thông tin về đơn đặt hàng cụ thể.

order/get/{guid} – Yêu cầu ví dụ

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

order/get/{guid} – Ví dụ về phản hồi

{
	"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} – Tham số phản hồi

guid – Thứ tự GUID
balance – tiền hiện có sẵn trong tài khoản nội bộ, TRX
days – Thời gian cung cấp năng lượng tính bằng ngày, nếu "period_type=days"
hours – Thời gian cung cấp năng lượng tính bằng giờ, nếu "period_type=hours"
to – TRX địa chỉ nơi cung cấp năng lượng
energy_amount – Lượng năng lượng
order_cost – chi phí đặt hàng, TRX
order_cost_paid – số tiền đã thanh toán, (trong trường hợp không đủ tiền trong tài khoản nội bộ, TRX số tiền này sẽ ít hơn "order_cost")
address_activation_fee – số tiền phí kích hoạt địa chỉ đích, TRX
energy_delegation_fee – phí cho kích thước đơn đặt hàng quá nhỏ, TRX
resource_txs – mảng chứa danh sách các giao dịch trong TRON blockchain nơi tài nguyên được ủy quyền và thu hồi (không được ủy quyền)
status – trạng thái đơn hàng, các giá trị có thể được mô tả ở đầu sách hướng dẫn này
payment_status – trạng thái thanh toán đơn hàng trong hệ thống thanh toán (các giá trị có thể phụ thuộc vào hệ thống thanh toán)

Phương "order/list" pháp – nhận danh sách đơn đặt hàng

Nhận danh sách các đơn đặt hàng.

order/list – Yêu cầu ví dụ

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

order/list – Yêu cầu params

sort (chuỗi, tùy chọn) - sắp xếp các mục, theo mặc định "created_at|desc"
per_page (số nguyên, tùy chọn) - giới hạn số lượng mục nhập cho mỗi phản hồi
page (số nguyên, tùy chọn) - số tuần tự của trang phản hồi
filter (mảng, arrays(objects) tùy chọn) - bộ lọc các mục nhập

order/list – Ví dụ về phản hồi

{
	"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 – Tham số phản hồi

guid – GUID của đơn đặt hàng
status – Trạng thái API phản hồi

Phương "account/list" pháp – liệt kê các tài khoản nội bộ

Nhận danh sách các tài khoản nội bộ, bao gồm số tiền hiện có sẵn. Vì có một tài khoản nội bộ riêng cho từng phần của trang web (buyer, affiliate, seller, dealer), có nhiều tài khoản trong tài khoản.

account/list – Yêu cầu ví dụ

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

account/list – Ví dụ về phản hồi

{
	"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 – Tham số phản hồi

guid – GUID của tài khoản nội bộ
id – tuần ID tự của tài khoản nội bộ
section – Số dư này thuộc về phần nào EnergyFather
balance – tiền có sẵn
currency –tiền tệ
user_id – GUID của người dùng

Phương "account/get/{id}" pháp – nhận tài khoản nội bộ chính xác

Lấy số dư của tài khoản nội bộ cho một phần cụ thể của EnergyFather . Vì mỗi phần có tài khoản (buyer, affiliate, seller, dealer) riêng, có một số tài khoản cho mỗi người dùng. Trước tiên, bạn có thể sử dụng "account/list" phương pháp để lấy danh sách của họ, tìm hiểu tài ‘id’ khoản quan tâm và sau đó sử dụng phương pháp này ‘id’ để lấy số dư của một tài khoản cụ thể.

account/get/{id} – Yêu cầu ví dụ

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

account/get/{id} – Ví dụ về phản hồi

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

account/get/{id} – Tham số phản hồi

guid – GUID của tài khoản nội bộ
id - ID tuần tự của tài khoản nội bộ
section - số dư này thuộc phần nào EnergyFather
balance - nguồn vốn sẵn có
currency -tiền tệ
user_id - GUID của người dùng