Activator — aktivasi alamat

Aktifkan alamat TRON yang belum pernah digunakan di on-chain. Alamat yang benar-benar baru tidak memiliki catatan akun, sehingga tidak dapat menerima delegasi Energy atau Bandwidth sampai alamat tersebut diaktifkan. Endpoint ini membuatkan akun untuk Anda dan mengembalikan hash transaksi aktivasi.

Aktivasi adalah operasi satu kali per alamat. Jika alamat sudah aktif, endpoint akan memberitahukan hal tersebut dan tidak mengenakan biaya apa pun.

URL Dasar Endpoint

https://netts.io/apiv2/activator

Jalur lama https://netts.io/apiv2/activation dilayani oleh layanan yang sama dan berperilaku secara identik. Integrasi baru sebaiknya menggunakan /apiv2/activator.

Header Permintaan

Header	Required	Description
Content-Type	Ya	application/json
X-API-KEY	Ya	Kunci API Anda dari dasbor Netts
X-Real-IP	Ya	Alamat IP dari whitelist Anda

user_id Anda diturunkan dari kunci API — Anda tidak perlu mengirimkannya.

---

Aktivasi — POST /apiv2/activator

Isi Permintaan

{ "targetAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE" }

Parameter	Type	Required	Description
targetAddress	string	Ya	Alamat TRON yang akan diaktifkan. Harus cocok dengan ^T[A-Za-z0-9]{33}$ (34 karakter, diawali dengan T).

Response — berhasil diaktifkan (200, code 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"
        }
    }
}

Parameter	Type	Description
orderId	string	Nomor pesanan aktivasi, selalu A + angka. Gunakan untuk rekonsiliasi.
targetAddress	string	Alamat yang telah diaktifkan
activation_cost	float	Jumlah yang dipotong dari saldo Anda, dalam TRX
user_balance_before	float	Saldo sebelum pemotongan
user_balance_after	float	Saldo setelah pemotongan
hash	string	Hash transaksi aktivasi. Verifikasi di explorer TRON mana pun.

Response — sudah aktif (200, code 2001)

Dikembalikan ketika alamat sudah ada di on-chain. Tidak ada biaya yang dikenakan.

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

Periksa code sebelum berasumsi bahwa pemotongan biaya telah terjadi: 10000 berarti Anda membayar, 2001 berarti Anda tidak dikenakan biaya.

Contoh

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

---

Harga

Item	Jumlah
Aktivasi	1.1 TRX
Alamat sudah aktif	0

Jumlahnya tetap dan tidak bergantung pada alamat atau kondisi jaringan. Biaya dipotong dari saldo Netts Anda pada saat aktivasi berhasil — tidak pernah sebelumnya. Aktivasi yang gagal tidak dikenakan biaya apa pun.

Saldo Anda harus mencukupi biaya tersebut, jika tidak permintaan akan ditolak dengan 403 (1004) dan tidak ada pesanan yang dibuat.

---

Kapan Anda membutuhkan ini

• Sebelum menyewa Energy atau Bandwidth untuk alamat baru. Delegasi ke akun yang belum ada akan gagal. Aktifkan terlebih dahulu, kemudian pesan.
• Sebelum transfer masuk pertama ke alamat yang Anda buat sendiri.

Anda tidak perlu memanggil endpoint ini untuk alamat yang pernah menerima TRX atau token — alamat tersebut sudah aktif, dan panggilan hanya akan mengembalikan 2001.

Memesan Energy untuk alamat baru

Endpoint Energy 1 jam mengaktifkan penerima yang belum aktif secara otomatis sebagai bagian dari pesanan, dan biaya aktivasi ditambahkan ke pesanan tersebut. Panggil activator secara eksplisit ketika Anda ingin alamat tersebut aktif sebelum penyewaan apa pun — misalnya untuk mengisi Bandwidth terlebih dahulu, yang memang memerlukan akun yang aktif.

---

Waktu Proses

Aktivasi adalah transaksi on-chain yang sesungguhnya. Endpoint mengembalikan respons setelah transaksi disiarkan dan catatan aktivasi ditulis, biasanya dalam beberapa detik.

Alamat baru dapat digunakan setelah transaksi dimasukkan ke dalam blok — hingga ~3 detik setelah respons, karena itulah interval blok TRON. Jika langkah Anda berikutnya bergantung pada alamat yang harus sudah aktif (misalnya memesan Bandwidth), konfirmasikan statusnya di on-chain melalui hash yang dikembalikan alih-alih langsung memanggilnya seketika.

---

Referensi Kode Kesalahan

Code	Description	HTTP Status
10000	Alamat berhasil diaktifkan, saldo dipotong	200
2001	Alamat sudah aktif, tidak ada biaya yang dikenakan	200
-1	Kunci API tidak valid / IP tidak ada dalam whitelist	401
1004	Saldo tidak mencukupi — pesan menyatakan apa yang diperlukan dan apa yang Anda miliki	403
-	Format targetAddress tidak valid (harus 34 karakter, diawali dengan T)	422
5003	Aktivasi gagal atau layanan sementara tidak tersedia — coba lagi nanti	503
5000	Kesalahan server internal	500

Status 503 berarti tidak ada biaya yang dikenakan dan tidak ada alamat yang diaktifkan: permintaan dapat dicoba kembali dengan aman.

Batas Laju

Dibatasi per IP sumber:

Periode	Batas
1 detik	5 permintaan
1 menit	60 permintaan

Batas Laju Terlampaui (429)

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

Catatan

• Idepompotensi menjadi tanggung jawab Anda. Endpoint ini tidak memiliki kunci idempotensi. Mengulang permintaan untuk alamat yang sudah aktif bersifat aman dan gratis (2001), tetapi dua permintaan simultan untuk alamat baru yang sama mungkin keduanya akan diproses. Lakukan serialisasi aktivasi per alamat di sisi Anda.
• Format orderId adalah A + angka dan bersifat unik di seluruh aktivasi.
• Tidak ada webhook yang dikirim untuk aktivasi saat ini — respons dan hash adalah konfirmasinya. Saat ini webhook hanya mencakup delegasi Energy yang telah dikonfirmasi, lihat Webhooks.