Activator — การเปิดใช้งานที่อยู่

เปิดใช้งานที่อยู่ TRON ที่ไม่เคยถูกใช้งานบนเชนมาก่อน ที่อยู่ใหม่เอี่ยมจะยังไม่มีบันทึกบัญชี ทำให้ไม่สามารถรับการมอบสิทธิ์ Energy หรือ Bandwidth ได้จนกว่าจะเปิดใช้งานสำเร็จ เอนด์พอยต์นี้ จะสร้างบัญชีให้คุณและส่งคืนแฮชของธุรกรรมการเปิดใช้งาน

การเปิดใช้งานเป็นการดำเนินการแบบครั้งเดียวต่อหนึ่งที่อยู่ หากที่อยู่นั้นเปิดใช้งานอยู่แล้ว เอนด์พอยต์ จะแจ้งให้คุณทราบและไม่มีการเรียกเก็บค่าบริการใด ๆ

URL ฐานของเอนด์พอยต์

https://netts.io/apiv2/activator

เส้นทางเดิม https://netts.io/apiv2/activation ให้บริการโดยระบบเดียวกันและทำงาน เหมือนกันทุกประการ สำหรับการผสานการทำงานใหม่ควรใช้ /apiv2/activator

ส่วนหัวของคำขอ

ส่วนหัว	จำเป็น	คำอธิบาย
Content-Type	ใช่	application/json
X-API-KEY	ใช่	คีย์ API ของคุณจากแดชบอร์ด Netts
X-Real-IP	ใช่	ที่อยู่ IP จากรายการที่อนุญาต (whitelist) ของคุณ

user_id ของคุณถูกถอดรหัสมาจากคีย์ API — คุณไม่จำเป็นต้องส่งค่านี้

---

เปิดใช้งาน — POST /apiv2/activator

เนื้อหาคำขอ

{ "targetAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE" }

ฟิลด์	ประเภท	จำเป็น	คำอธิบาย
targetAddress	string	ใช่	ที่อยู่ TRON ที่ต้องการเปิดใช้งาน ต้องตรงตามรูปแบบ ^T[A-Za-z0-9]{33}$ (ความยาว 34 ตัวอักษร ขึ้นต้นด้วย T)

การตอบกลับ — เปิดใช้งานสำเร็จ (200, โค้ด 10000)

{
    "detail": {
        "code": 10000,
        "msg": "Address activated successfully, 1.1 TRX deducted",
        "data": {
            "orderId": "A123456",
            "targetAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
            "activation_cost": 1.1,
            "user_balance_before": 500.00,
            "user_balance_after": 498.90,
            "hash": "0000000000000000000000000000000000000000000000000000000000000000"
        }
    }
}

ฟิลด์	ประเภท	คำอธิบาย
orderId	string	หมายเลขคำสั่งซื้อการเปิดใช้งาน ขึ้นต้นด้วย A + ตัวเลขเสมอ ใช้สำหรับการกระทบยอด
targetAddress	string	ที่อยู่ที่ได้รับการเปิดใช้งาน
activation_cost	float	จำนวนเงินที่หักจากยอดคงเหลือของคุณ มีหน่วยเป็น TRX
user_balance_before	float	ยอดคงเหลือก่อนทำการหัก
user_balance_after	float	ยอดคงเหลือหลังทำการหัก
hash	string	แฮชธุรกรรมการเปิดใช้งาน ตรวจสอบได้บน TRON explorer ใดก็ได้

การตอบกลับ — เปิดใช้งานอยู่แล้ว (200, โค้ด 2001)

จะถูกส่งคืนเมื่อที่อยู่นี้มีอยู่บนเชนแล้ว ไม่มีการหักค่าบริการใด ๆ

{
    "detail": {
        "code": 2001,
        "msg": "Address is already activated",
        "data": {
            "targetAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
            "status": "already_activated",
            "user_balance": 500.00,
            "activation_cost": 0,
            "activation_required": false
        }
    }
}

ตรวจสอบ code ก่อนที่จะสันนิษฐานว่ามีการหักเงิน: 10000 หมายถึงคุณชำระเงินแล้ว ส่วน 2001 หมายถึงไม่มีการหักเงิน

ตัวอย่าง

curl -X POST https://netts.io/apiv2/activator \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your_api_key" \
  -H "X-Real-IP: your_whitelisted_ip" \
  -d '{"targetAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"}'

---

ราคา

รายการ	จำนวน
การเปิดใช้งาน	1.1 TRX
ที่อยู่เปิดใช้งานอยู่แล้ว	0

จำนวนนี้เป็นอัตราคงที่และไม่ขึ้นอยู่กับที่อยู่หรือสภาวะของเครือข่าย โดยจะถูกหัก จากยอดคงเหลือใน Netts ของคุณในทันทีที่การเปิดใช้งานสำเร็จ — จะไม่มีการหักก่อนหน้านั้นเด็ดขาด หากการเปิดใช้งานล้มเหลว จะไม่มีค่าใช้จ่ายใด ๆ

ยอดคงเหลือของคุณต้องครอบคลุมค่าใช้จ่าย มิฉะนั้นคำขอจะถูกปฏิเสธด้วยสถานะ 403 (1004) และไม่มี การสร้างคำสั่งซื้อ

---

กรณีที่คุณจำเป็นต้องใช้

• ก่อนการเช่า Energy หรือ Bandwidth ให้กับที่อยู่ใหม่ การมอบสิทธิ์ไปยังบัญชีที่ยังไม่มีอยู่จริง จะล้มเหลว ให้เปิดใช้งานก่อน แล้วจึงค่อยสั่งซื้อ
• ก่อนการโอนเงินเข้าครั้งแรก ไปยังที่อยู่ที่คุณสร้างขึ้นมาเอง

คุณไม่จำเป็นต้องเรียกใช้เอนด์พอยต์นี้สำหรับที่อยู่ที่เคยได้รับ TRX หรือโทเค็นมาก่อน — เนื่องจาก ที่อยู่นั้นเปิดใช้งานอยู่แล้ว และการเรียกใช้จะส่งคืนเพียงแค่ 2001

การสั่งซื้อ Energy สำหรับที่อยู่ใหม่

เอนด์พอยต์ Energy แบบ 1 ชั่วโมงจะทำการเปิดใช้งานที่อยู่ผู้รับที่ยังไม่ได้เปิดใช้งานโดยอัตโนมัติซึ่งรวมอยู่ในคำสั่งซื้อนั้น และ ค่าใช้จ่ายในการเปิดใช้งานจะถูกเพิ่มเข้าไปในคำสั่งซื้อดังกล่าว ให้เรียกใช้ Activator โดยตรงเมื่อคุณต้องการให้ที่อยู่ เปิดใช้งานก่อนการเช่าใด ๆ — ตัวอย่างเช่น เพื่อเติม Bandwidth ก่อน ซึ่งจำเป็นต้องมีบัญชี ที่เปิดใช้งานแล้ว

---

ระยะเวลา

การเปิดใช้งานเป็นธุรกรรมจริงบนบล็อกเชน เอนด์พอยต์จะส่งคืนผลลัพธ์หลังจากธุรกรรมถูกบรอดแคสต์และ บันทึกการเปิดใช้งานถูกเขียนเรียบร้อยแล้ว ซึ่งโดยทั่วไปจะใช้เวลาเพียงไม่กี่วินาที

ที่อยู่จะสามารถใช้งานได้จริงเมื่อธุรกรรมถูกรวมเข้าไปในบล็อกแล้วเท่านั้น — ใช้เวลาสูงสุดประมาณ 3 วินาที หลังจากการตอบกลับ เนื่องจากนั่นคือช่วงเวลาการสร้างบล็อกของ TRON หากขั้นตอนถัดไปของคุณขึ้นอยู่กับสถานะการเปิดใช้งานของ ที่อยู่ (เช่น การสั่งซื้อ Bandwidth) ให้ยืนยันสถานะบนเชนด้วย hash ที่ส่งคืนมา แทนที่จะเรียกใช้งานทันที

---

เอกสารอ้างอิงรหัสข้อผิดพลาด

รหัส	คำอธิบาย	สถานะ HTTP
10000	เปิดใช้งานที่อยู่สำเร็จ, หักยอดคงเหลือแล้ว	200
2001	ที่อยู่เปิดใช้งานอยู่แล้ว, ไม่มีการหักค่าใช้จ่าย	200
-1	คีย์ API ไม่ถูกต้อง / IP ไม่อยู่ในรายการที่อนุญาต	401
1004	ยอดเงินคงเหลือไม่เพียงพอ — ข้อความจะระบุจำนวนที่ต้องการและจำนวนที่คุณมี	403
-	รูปแบบ targetAddress ไม่ถูกต้อง (ต้องมีความยาว 34 ตัวอักษร, ขึ้นต้นด้วย T)	422
5003	การเปิดใช้งานล้มเหลวหรือบริการไม่พร้อมใช้งานชั่วคราว — ให้ลองใหม่อีกครั้งในภายหลัง	503
5000	ข้อผิดพลาดภายในเซิร์ฟเวอร์	500

สถานะ 503 หมายความว่าไม่มีการหักค่าใช้จ่ายและไม่มีการเปิดใช้งานที่อยู่: คุณสามารถลองส่งคำขอใหม่อีกครั้งได้อย่างปลอดภัย

การจำกัดอัตราการส่งคำขอ

จำกัดตาม IP ต้นทาง:

ช่วงเวลา	ขีดจำกัด
1 วินาที	5 คำขอ
1 นาที	60 คำขอ

เกินขีดจำกัดอัตราการส่งคำขอ (429)

{ "message": "API rate limit exceeded" }

หมายเหตุ

• คุณต้องจัดการเรื่อง Idempotency เอง เอนด์พอยต์นี้ไม่มีคีย์ idempotency การส่งคำขอซ้ำสำหรับที่อยู่ ที่เปิดใช้งานอยู่แล้วนั้นปลอดภัยและไม่มีค่าใช้จ่าย (2001) แต่การส่งคำขอพร้อมกันสองรายการสำหรับที่อยู่ใหม่เอี่ยม ที่เหมือนกันอาจดำเนินการทั้งคู่ได้ โปรดจัดการลำดับการเปิดใช้งานทีละรายการสำหรับแต่ละที่อยู่บนฝั่งของคุณ
• รูปแบบ orderId คือ A + ตัวเลข และไม่ซ้ำกันในแต่ละการเปิดใช้งาน
• ไม่มีการส่ง Webhook สำหรับการเปิดใช้งาน ในปัจจุบัน — การตอบกลับและ hash ถือเป็นการยืนยันแล้ว ปัจจุบัน Webhook รองรับเฉพาะการยืนยันการมอบสิทธิ์ Energy เท่านั้น ดูเพิ่มเติมที่ Webhooks