บริการนี้EnergyFatherช่วยซื้อ (เช่า) พลังงานและแบนด์วิดท์ที่จําเป็นในการส่งธุรกรรมเข้าและUSDTโทเค็นการเข้ารหัสลับอื่นๆ TRC20 แบนด์วิดท์ยังจําเป็นในการส่งธุรกรรมประเภทใดก็ได้บนTRONบล็อกเชน เช่น การส่ง TRX รับรางวัล และการโหวตให้ Super Representatives
ขั้นตอนการซื้อพลังงาน
ในการซื้อพลังงาน คุณต้องลงทะเบียนในEnergyFatherบริการ คว้าโทเค็นการอนุญาตจากหน้า "โทเค็น>APIผู้ซื้อ" และเติมเงินในบัญชีผู้ซื้อ
หลังจากสร้างคําสั่งซื้อ (วิธีการ‘buy/energy’) พลังงานสามารถส่งมอบได้ด้วยความล่าช้าหลายวินาทีหรือแม้กระทั่งนาทีดังนั้นเมื่อพัฒนาระบบอัตโนมัติขอแนะนําให้ตรวจสอบการดําเนินการตามคําสั่งเป็นระยะโดยขอวิธีการ ‘order/get/{guid}’
ตัวอย่างเช่น หากคุณวางแผนที่จะส่งและUSDTต้องการทําธุรกรรมให้ถูกลงด้วยการซื้อพลังงาน ให้ทําดังต่อไปนี้:
- ขอวิธีการ‘buy/energy’ประมาณปริมาณพลังงานที่ต้องการและซื้อ
- วิธีการขอเป็น‘order/get/{guid}’ระยะจนกว่าจะได้รับมอบหมายพลังงาน (โดยปกติจะใช้เวลาสองสามวินาที)
- ส่ง USDT (พลังงานที่ซื้อจะถูกนําไปใช้ชําระค่าธรรมเนียมการทําธุรกรรม)
หมายเหตุทั่วไป
ในเอกสารนี้ นิพจน์ที่ห่อเป็นวงเล็บปีกกา เช่น ‘{guid}’ หรือ หมายถึง ‘{id}’ ค่าของตัวแปรที่สอดคล้องกัน:
- ‘{guid}’ เป็นตัวระบุเฉพาะส่วนกลางของวัตถุใน EnergyFather (โดยปกติจะเป็น 8 หลัก)
- ‘{id}’ คือหมายเลขลําดับของอ็อบเจ็กต์สําหรับผู้ใช้รายนี้ (การกําหนดหมายเลขขึ้นต้นด้วย ‘1’ สําหรับผู้ใช้แต่ละราย)
API จุดสิ้นสุด
https://panel.energyfather.com/api/v1/private
ส่งคําขอโดยใช้POSTวิธีการ
การอนุมัติคําขอ
ในการยืนยัน (อนุญาต) คําขอไปยังส่วนตัว API ควรส่งส่วนHTTPหัว:
Token: {token}
การจัดการโทเค็นการอนุญาตอยู่ในแผงควบคุมในหน้า "โทเค็น>APIผู้ซื้อ"
ตัวอย่างเช่น คุณสามารถรับข้อมูลเกี่ยวกับ 123456 การสั่งซื้อได้ด้วยวิธีต่อไปนี้:
CURL -X POST 'https://panel.energyfather.com/api/v1/private/order/get/123456' -H 'Token: 123456xxxxxxxxxxxxxxxxxxxxxxNOPQRS'
สถานะการสั่งซื้อ
- "0" -รอ คําสั่งเพิ่งถูกสร้างขึ้น
- "1" - รอการชําระเงิน ลิงก์การชําระเงินถูกสร้างขึ้นแล้ว กําลังEnergyFatherรอการเรียกกลับจากระบบการชําระเงิน สถานะนี้จะไม่ถูกใช้หากคําสั่งซื้อชําระเงินทั้งหมดด้วยเงินที่มีอยู่ในบัญชีภายใน
- "2" - ขั้นตอนการมอบหมายพลังงานกําลังดําเนินอยู่
- "3" -มอบ หมาย พลังงานถูกแจกออกไป
- "4" - เรียกคืน (ไม่ได้มอบสิทธิ์) พลังงานจะถูกถอนออกเนื่องจากสิ้นสุดระยะเวลาที่ชําระเงิน
- "5" -จ่าย คําสั่งซื้อจะได้รับการชําระเงินและเพิ่มลงในคิวสําหรับการจัดส่งพลังงาน
- "6" -ความผิดพลาด
ลําดับปกติของสถานะ: 0, 5, 2, 3, 4 .
- /api/v1/private/buy/energy – ซื้อพลังงาน (จ่ายจากบัญชีภายใน)
- /api/v1/private/order/list – รับรายการคําสั่งซื้อของคุณ
- /api/v1/private/order/get/{guid} – รับข้อมูลเกี่ยวกับการสั่งซื้อของคุณ
- /api/v1/private/account/list – รับรายการบัญชีภายในของคุณ
- /api/v1/private/account/get/{id} – รับข้อมูลเกี่ยวกับบัญชีภายในของคุณ
"buy/energy" วิธีการ – ซื้อพลังงาน (จ่ายจากบัญชีภายใน)
ขอซื้อพลังงานโดยลูกค้าที่ลงทะเบียนด้วยเดบิตจากบัญชีภายใน พลังงานจะถูกส่งไปยังที่อยู่ที่ระบุทันที
หากบัญชีภายในมีเงินไม่เพียงพอ คําสั่งซื้อจะถูกสร้างขึ้นและได้รับสถานะ"6"ทันที (ข้อผิดพลาด) ในกรณีนี้คุณต้องไปที่แผงควบคุมฝากเงินบางส่วนแล้วส่งคําขอใหม่APIสําหรับการซื้อพลังงาน
มีสองวิธีในการกําหนดปริมาณพลังงานที่จะซื้อ:
ก) คุณอาจกําหนดปริมาณพลังงานที่แน่นอนใน"amount"พารามิเตอร์ จากนั้นคุณควรตั้งค่าamount_source="amount"ด้วย
b) หากคุณไม่ทราบว่าต้องใช้พลังงานเท่าใดในการส่งUSDTธุรกรรมหรือโทเค็นอื่น ๆ คุณสามารถตั้งค่าamount_source="estimate"และกรอกพารามิเตอร์ที่เหมาะสม(estimate_to, estimate_token, estimate_adjust_percent)ได้
buy/energy : ตัวอย่างคําขอที่มีปริมาณพลังงานที่แน่นอน
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 : ตัวอย่างคําขอพร้อมการคํานวณปริมาณพลังงานที่ต้องการ
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 : พารามิเตอร์คําขอ
- to (string, required) – TRON ที่อยู่ที่จะมอบหมายพลังงาน
- period_amount (จํานวนเต็ม จําเป็น) – ระยะเวลาในการซื้อพลังงาน
- period_type (สตริง, จําเป็น) – ประเภทของช่วงเวลา ค่าที่เป็นไปได้: days, hours .
- format (สตริง, ไม่บังคับ) – รูปแบบการตอบกลับ ค่าที่เป็นไปได้: json (default), xml .
- amount_source (สตริง, จําเป็น) – อัลกอริทึมสําหรับกําหนดปริมาณพลังงานที่ได้รับมอบหมาย ถ้าค่าเป็น "amount" จะใช้ค่าของพารามิเตอร์ "amount" หากค่าเป็น "estimate" ปริมาณพลังงานที่ต้องการจะถูกคํานวณตามพารามิเตอร์ estimate_to, estimate_token, estimate_adjust_percent ค่าที่เป็นไปได้: amount, estimate .
- amount (จํานวนเต็ม ต้องระบุหาก amount_source="amount" ) – ปริมาณพลังงานที่จะซื้อ มันจะถูกละเว้นถ้า amount_source="estimate" .
- estimate_to (string, required if amount_source="estimate" ) – รายการTRONที่อยู่ที่คั่นด้วยจุลภาคที่มีการวางแผนที่จะส่งธุรกรรมโทเค็น
- estimate_token (สตริง, ต้องระบุหาก amount_source="estimate" ) – TRC20 โทเค็น ค่าที่เป็นไปได้ (คํานึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่): USDT, USDC, USDD, USDJ, JST, TUSD, stUSDT, WTRX .
- estimate_adjust_percent (ทศนิยม ต้องระบุหาก amount_source="estimate" ) – ปริมาณพลังงานส่วนเกินที่แสดงเป็นเปอร์เซ็นต์ ส่วนเกินนี้จําเป็นเพื่อหลีกเลี่ยงการเผาไหม้ TRX ซึ่งอาจเกิดขึ้นได้หากที่อยู่มีพลังงานในปริมาณที่จําเป็น ค่าที่แนะนําคือ 0.04%.
สําคัญ: ปัจจุบันมีเพียง 6 จุดเท่านั้นที่ใช้ได้: 1 hour และ 1, 3, 7, 15, 30 days .
buy/energy:การตอบสนอง
ในกรณีที่สําเร็จการตอบกลับจะมีคําสั่ง GUID ซึ่งคุณสามารถรับรายละเอียดที่แท้จริงได้ในภายหลัง
{ "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" }
หากคําขอมี amount_source="estimate" การตอบกลับจะมีส่วน"estimate_task"เพิ่มเติม เช่น:
{ "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 : พารามิเตอร์การตอบสนอง
- guid – คําสั่ง GUID
- balance – เงินทุนที่มีอยู่ในบัญชีTRXภายใน
- days – ระยะเวลาของการจัดหาพลังงานเป็นวัน "period_type=days"
- hours – ระยะเวลาของการจัดหาพลังงานเป็นชั่วโมง "period_type=hours"
- estimate_task – การคํานวณ (ประมาณการ) พลังงานที่จําเป็นในการส่งTRC20ธุรกรรมจากที่อยู่หนึ่งไปยังTRONรายการที่อยู่อื่น TRON
"order/get/{guid}" วิธีการ – การรับรายละเอียดของคําสั่งซื้อ
การรับข้อมูลเกี่ยวกับคําสั่งซื้อเฉพาะ
order/get/{guid} – ตัวอย่างคําขอ
curl -X 'POST' 'https://panel.energyfather.com/api/v1/private/order/get/12345' -H 'Token: 123456xxxxxxxxxxxxxxxxxxxxxxNOPQRS'
order/get/{guid} – ตัวอย่างการตอบสนอง
{ "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} – พารามิเตอร์การตอบสนอง
- guid – คําสั่ง GUID
- balance – เงินทุนที่มีอยู่ในบัญชีTRXภายใน
- days – ระยะเวลาของการจัดหาพลังงานเป็นวัน "period_type=days"
- hours – ระยะเวลาของการจัดหาพลังงานเป็นชั่วโมง "period_type=hours"
- to – TRX ที่อยู่ที่ส่งพลังงาน
- energy_amount – ปริมาณพลังงาน
- order_cost – ค่าสั่งซื้อ TRX
- order_cost_paid – จํานวนเงินที่ชําระไปTRXแล้ว (ในกรณีที่เงินในบัญชีภายในไม่เพียงพอจํานวนเงินนี้จะน้อยกว่า "order_cost" )
- address_activation_fee – จํานวนค่าธรรมเนียมสําหรับการเปิดใช้งานที่อยู่TRXปลายทาง
- energy_delegation_fee – ค่าธรรมเนียมสําหรับขนาดการสั่งซื้อTRXที่เล็กเกินไป
- resource_txs – อาร์เรย์ที่มีรายการธุรกรรมในTRONบล็อกเชนที่มีการมอบหมายและเรียกคืนทรัพยากร (ไม่ได้มอบหมาย)
- status – สถานะการสั่งซื้อ ค่าที่เป็นไปได้ได้อธิบายไว้ที่ตอนต้นของคู่มือนี้
- payment_status – สถานะการชําระเงินตามคําสั่งซื้อในระบบการชําระเงิน (ค่าที่เป็นไปได้ขึ้นอยู่กับระบบการชําระเงิน)
"order/list" วิธีการ – การรับรายการคําสั่งซื้อ
การรับรายการคําสั่งซื้อ
order/list – ตัวอย่างคําขอ
curl -X 'POST' 'https://panel.energyfather.com/api/v1/private/order/list' -H 'Token: 123456xxxxxxxxxxxxxxxxxxxxxxNOPQRS'
order/list – พารามิเตอร์คําขอ
- sort (สตริง, ไม่บังคับ) – การเรียงลําดับรายการตามค่าเริ่มต้น "created_at|desc"
- per_page (จํานวนเต็ม ไม่บังคับ) – จํากัดจํานวนรายการต่อการตอบกลับ
- page (จํานวนเต็ม ไม่บังคับ) – หมายเลขลําดับของหน้าตอบกลับ
- filter (อาร์เรย์ของ arrays(objects), ไม่บังคับ) – ตัวกรองของรายการ
order/list – ตัวอย่างการตอบสนอง
{ "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 – พารามิเตอร์การตอบสนอง
- guid – GUID ของคําสั่งซื้อ
- status – สถานะการAPIตอบสนอง
"account/list" วิธีการ – รายการบัญชีภายใน
การรับรายชื่อบัญชีภายใน รวมถึงจํานวนเงินที่มีอยู่ในปัจจุบัน เนื่องจากมีบัญชีภายในแยกต่างหากสําหรับแต่ละส่วนของไซต์ (buyer, affiliate, seller, dealer) จึงมีหลายบัญชีในบัญชี
account/list – ตัวอย่างคําขอ
curl -X 'POST' 'https://panel.energyfather.com/api/v1/private/account/list' -H 'Token: 123456xxxxxxxxxxxxxxxxxxxxxxNOPQRS'
account/list – ตัวอย่างการตอบสนอง
{ "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 – พารามิเตอร์การตอบสนอง
- guid – GUID ของบัญชีภายใน
- id – ตามลําดับIDของบัญชีภายใน
- section – ยอดคงเหลือนี้อยู่ในส่วนใด EnergyFather
- balance – เงินทุนที่มีอยู่
- currency –เงินตรา
- user_id – GUID ของผู้ใช้
"account/get/{id}" วิธีการ – การรับบัญชีภายในที่แน่นอน
การรับยอดคงเหลือของบัญชีภายในสําหรับส่วนเฉพาะของ EnergyFather . เนื่องจากแต่ละส่วนมีบัญชี(buyer, affiliate, seller, dealer)ของตัวเอง จึงมีหลายบัญชีสําหรับผู้ใช้แต่ละคน ก่อนอื่น"account/list"คุณสามารถใช้วิธีการนี้เพื่อรับรายการค้นหา‘id’บัญชีที่น่าสนใจจากนั้นใช้วิธีนี้‘id’เพื่อรับยอดคงเหลือของบัญชีใดบัญชีหนึ่ง
account/get/{id} – ตัวอย่างคําขอ
curl -X 'POST' 'https://panel.energyfather.com/api/v1/private/account/get/1' -H 'Token: 123456xxxxxxxxxxxxxxxxxxxxxxNOPQRS'
account/get/{id} – ตัวอย่างการตอบสนอง
{ "status": "ok", "data": { "guid": 64463815, "user_id": 81841325, "id": 2, "section": "buyer", "currency": "TRX", "balance": "41.704" } }
account/get/{id} – พารามิเตอร์การตอบสนอง
- guid – GUID ของบัญชีภายใน
- id - รหัสตามลําดับของบัญชีภายใน
- section - ยอดคงเหลือนี้อยู่ในส่วนใด EnergyFather
- balance - เงินทุนที่มีอยู่
- currency -เงินตรา
- user_id - GUID ของผู้ใช้