Activator — kích hoạt địa chỉ

Kích hoạt địa chỉ TRON chưa từng được sử dụng trên chuỗi. Một địa chỉ hoàn toàn mới sẽ không có bản ghi tài khoản, do đó không thể nhận Energy hoặc Bandwidth được ủy quyền cho đến khi được kích hoạt. Điểm cuối này sẽ tạo tài khoản cho bạn và trả về mã băm giao dịch (transaction hash) kích hoạt.

Kích hoạt là thao tác một lần duy nhất cho mỗi địa chỉ. Nếu địa chỉ đã hoạt động, điểm cuối sẽ thông báo cho bạn và không tính phí.

URL gốc của điểm cuối

https://netts.io/apiv2/activator

Đường dẫn cũ https://netts.io/apiv2/activation được phục vụ bởi cùng một dịch vụ và hoạt động hoàn toàn giống nhau. Các tích hợp mới nên sử dụng /apiv2/activator.

Tiêu đề yêu cầu

Tiêu đề	Bắt buộc	Mô tả
Content-Type	Có	application/json
X-API-KEY	Có	Khóa API của bạn từ bảng điều khiển Netts
X-Real-IP	Có	Địa chỉ IP từ danh sách trắng của bạn

user_id của bạn được lấy từ khóa API — bạn không bao giờ phải truyền giá trị này.

---

Kích hoạt — POST /apiv2/activator

Thân yêu cầu

{ "targetAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE" }

Trường	Loại	Bắt buộc	Mô tả
targetAddress	string	Có	Địa chỉ TRON cần kích hoạt. Phải khớp với định dạng ^T[A-Za-z0-9]{33}$ (34 ký tự, bắt đầu bằng chữ T).

Phản hồi — đã kích hoạt (200, mã 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"
        }
    }
}

Trường	Loại	Mô tả
orderId	string	Mã đơn hàng kích hoạt, luôn là A + các chữ số. Sử dụng mã này để đối soát.
targetAddress	string	Địa chỉ đã được kích hoạt
activation_cost	float	Số tiền bị trừ khỏi số dư của bạn, tính bằng TRX
user_balance_before	float	Số dư trước khi trừ
user_balance_after	float	Số dư sau khi trừ
hash	string	Mã băm giao dịch kích hoạt. Xác minh mã này trên bất kỳ trình khám phá TRON nào.

Phản hồi — đã hoạt động sẵn (200, mã 2001)

Được trả về khi địa chỉ đã tồn tại trên chuỗi. Không bị trừ tiền.

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

Kiểm tra code trước khi cho rằng đã phát sinh phí: 10000 nghĩa là bạn đã thanh toán, 2001 nghĩa là bạn không mất phí.

Ví dụ

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

---

Giá cả

Mục	Số tiền
Kích hoạt	1.1 TRX
Địa chỉ đã hoạt động sẵn	0

Số tiền là cố định và không phụ thuộc vào địa chỉ hay điều kiện mạng. Số tiền sẽ bị trừ khỏi số dư Netts của bạn tại thời điểm kích hoạt thành công — không bao giờ trừ trước. Kích hoạt thất bại sẽ không tốn chi phí nào.

Số dư của bạn phải đủ chi trả chi phí, nếu không yêu cầu sẽ bị từ chối với mã 403 (1004) và không có đơn hàng nào được tạo.

---

Khi nào bạn cần điều này

• Trước khi thuê Energy hoặc Bandwidth cho một địa chỉ mới tinh. Việc ủy quyền cho một tài khoản chưa tồn tại sẽ thất bại. Hãy kích hoạt trước, sau đó mới đặt hàng.
• Trước lần chuyển tiền đến đầu tiên tới một địa chỉ do chính bạn tạo ra.

Bạn không cần gọi điểm cuối này cho một địa chỉ đã từng nhận TRX hoặc một token — nó đã hoạt động sẵn rồi, và lệnh gọi sẽ chỉ trả về 2001.

Đặt mua Energy cho địa chỉ mới

Điểm cuối Energy 1 giờ sẽ tự động kích hoạt bên nhận chưa hoạt động như một phần của đơn hàng, và chi phí kích hoạt sẽ được cộng vào đơn hàng đó. Hãy gọi activator một cách chủ động khi bạn muốn địa chỉ hoạt động trước bất kỳ giao dịch thuê nào — ví dụ: để nạp Bandwidth trước, việc này bắt buộc phải có tài khoản đang hoạt động.

---

Thời gian xử lý

Kích hoạt là một giao dịch thực tế trên chuỗi. Điểm cuối sẽ trả về sau khi giao dịch được phát sóng và bản ghi kích hoạt được ghi nhận, thường là trong vòng vài giây.

Địa chỉ chỉ có thể sử dụng được sau khi giao dịch được đưa vào một khối — tối đa ~3 giây sau khi có phản hồi, vì đó là khoảng thời gian tạo khối của TRON. Nếu bước tiếp theo của bạn phụ thuộc vào việc địa chỉ đã hoạt động (chẳng hạn như đặt mua Bandwidth), hãy xác nhận trạng thái trên chuỗi bằng hash được trả về thay vì gọi ngay lập tức.

---

Bảng mã lỗi tham chiếu

Mã	Mô tả	Trạng thái HTTP
10000	Địa chỉ đã được kích hoạt, đã trừ số dư	200
2001	Địa chỉ đã được kích hoạt từ trước, không tính phí	200
-1	Khóa API không hợp lệ / IP không nằm trong danh sách trắng	401
1004	Không đủ tiền — thông báo nêu rõ số tiền cần thiết và số dư bạn hiện có	403
-	Định dạng targetAddress không hợp lệ (phải có 34 ký tự, bắt đầu bằng T)	422
5003	Kích hoạt thất bại hoặc dịch vụ tạm thời không khả dụng — thử lại sau	503
5000	Lỗi máy chủ nội bộ	500

Mã 503 có nghĩa là chưa phát sinh khoản phí nào và chưa có địa chỉ nào được kích hoạt: bạn có thể thử lại yêu cầu một cách an toàn.

Giới hạn tần suất

Giới hạn theo IP nguồn:

Khoảng thời gian	Giới hạn
1 giây	5 yêu cầu
1 phút	60 yêu cầu

Vượt quá giới hạn tần suất (429)

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

Lưu ý

• Tính lũy đẳng phụ thuộc vào bạn. Điểm cuối không có khóa lũy đẳng (idempotency key). Việc lặp lại một yêu cầu cho một địa chỉ đã hoạt động là an toàn và miễn phí (2001), nhưng hai yêu cầu đồng thời cho cùng một địa chỉ hoàn toàn mới có thể đều được xử lý. Hãy tuần tự hóa việc kích hoạt cho từng địa chỉ ở phía bạn.
• Định dạng orderId là A + các chữ số và là duy nhất giữa các lần kích hoạt.
• Hiện tại không có webhook nào được gửi cho việc kích hoạt — phản hồi và hash chính là sự xác nhận. Webhook hiện chỉ áp dụng cho việc ủy quyền Energy đã được xác nhận, xem Webhooks.