Activator — adres aktivasyonu

Zincir üzerinde daha önce hiç kullanılmamış bir TRON adresini aktive edin. Yepyeni bir adresin hesap kaydı bulunmaz; bu nedenle aktive edilene kadar delege edilmiş Energy veya Bandwidth alamaz. Bu uç nokta hesabı sizin yerinize oluşturur ve aktivasyon işlem karmasını (hash) döndürür.

Aktivasyon, adres başına tek seferlik bir işlemdir. Adres zaten aktifse, uç nokta bunu size bildirir ve hiçbir ücret almaz.

Uç nokta temel URL'si

https://netts.io/apiv2/activator

Eski yol olan https://netts.io/apiv2/activation da aynı servis tarafından sunulur ve birebir aynı şekilde davranır. Yeni entegrasyonlar /apiv2/activator yolunu kullanmalıdır.

İstek Başlıkları

Başlık	Zorunlu	Açıklama
Content-Type	Evet	application/json
X-API-KEY	Evet	Netts kontrol panelinizdeki API anahtarınız
X-Real-IP	Evet	Beyaz listenizdeki IP adresi

user_id bilginiz API anahtarından türetilir — bunu asla siz göndermezsiniz.

---

Aktive Et — POST /apiv2/activator

İstek gövdesi

{ "targetAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE" }

Alan	Tür	Zorunlu	Açıklama
targetAddress	string	Evet	Aktive edilecek TRON adresi. ^T[A-Za-z0-9]{33}$ ile eşleşmelidir (34 karakter, T ile başlar).

Yanıt — aktive edildi (200, kod 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"
        }
    }
}

Alan	Tür	Açıklama
orderId	string	Aktivasyon sipariş numarası, her zaman A + rakamlardan oluşur. Mutabakat için kullanın.
targetAddress	string	Aktive edilen adres
activation_cost	float	Bakiyenizden düşülen tutar, TRX cinsinden
user_balance_before	float	Kesintiden önceki bakiye
user_balance_after	float	Kesintiden sonraki bakiye
hash	string	Aktivasyon işlem karması (hash). Herhangi bir TRON gezgininde doğrulayın.

Yanıt — zaten aktif (200, kod 2001)

Adres zincir üzerinde zaten mevcut olduğunda döndürülür. Hiçbir ücret alınmaz.

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

Bir ücret tahsil edildiğini varsaymadan önce code değerini kontrol edin: 10000 ödeme yaptığınız, 2001 ise ödeme yapmadığınız anlamına gelir.

Örnek

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

---

Fiyat

Kalem	Tutar
Aktivasyon	1.1 TRX
Adres zaten aktif	0

Tutar sabittir; adrese veya ağ koşullarına bağlı değildir. Aktivasyon başarılı olduğu anda Netts bakiyenizden düşülür — asla daha önce değil. Başarısız bir aktivasyonun hiçbir maliyeti yoktur.

Bakiyeniz bu maliyeti karşılamalıdır, aksi takdirde istek 403 (1004) ile reddedilir ve hiçbir sipariş oluşturulmaz.

---

Buna ne zaman ihtiyaç duyarsınız

• Yeni bir adres için Energy veya Bandwidth kiralamadan önce. Mevcut olmayan bir hesaba yapılan delegasyon başarısız olur. Önce aktive edin, ardından sipariş verin.
• Kendi oluşturduğunuz bir adrese yapılacak ilk gelen transferden önce.

Daha önce TRX veya bir token almış bir adres için bu uç noktayı çağırmanıza gerek yoktur — bu adres zaten aktiftir ve çağrı yalnızca 2001 döndürür.

Yeni bir adres için Energy siparişi verme

1 saatlik Energy uç noktası, aktif olmayan bir alıcıyı siparişin bir parçası olarak kendi kendine aktive eder ve aktivasyon maliyeti bu siparişe eklenir. Herhangi bir kiralamadan önce adresin aktif olmasını istediğinizde aktivatörü doğrudan çağırın — örneğin, aktif bir hesap gerektiren Bandwidth yüklemesini önceden yapmak için.

---

Zamanlama

Aktivasyon, gerçek bir zincir üstü (on-chain) işlemdir. Uç nokta, işlem yayınlandıktan ve aktivasyon kaydı yazıldıktan sonra, genellikle birkaç saniye içinde yanıt döner.

Adres, ancak işlem bir bloğa dahil edildikten sonra kullanılabilir hale gelir — TRON blok aralığı bu kadar olduğundan, yanıttan sonra yaklaşık 3 saniyeye kadar sürebilir. Bir sonraki adımınız adresin aktif olmasına bağlıysa (örneğin Bandwidth siparişi vermek), hemen çağırmak yerine durumu döndürülen hash ile zincir üzerinde doğrulayın.

---

Hata Kodu Referansı

Kod	Açıklama	HTTP Durumu
10000	Adres aktive edildi, bakiye düşüldü	200
2001	Adres zaten aktive edilmiş, ücret alınmadı	200
-1	Geçersiz API anahtarı / IP beyaz listede değil	401
1004	Yetersiz bakiye — mesaj neyin gerekli olduğunu ve neye sahip olduğunuzu belirtir	403
-	Geçersiz targetAddress biçimi (34 karakter olmalı, T ile başlamalı)	422
5003	Aktivasyon başarısız oldu veya servis geçici olarak kullanılamıyor — daha sonra tekrar deneyin	503
5000	Sunucu içi hata	500

Bir 503 hatası, hiçbir ücret alınmadığı ve hiçbir adresin aktive edilmediği anlamına gelir: istek güvenle tekrar denenebilir.

İstek Limitleri (Rate Limits)

Kaynak IP başına sınırlandırılmıştır:

Dönem	Limit
1 saniye	5 istek
1 dakika	60 istek

İstek Limiti Aşıldı (429)

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

Notlar

• Eşkuvvetlilik (idempotency) sizin sorumluluğunuzdadır. Uç noktanın bir eşkuvvetlilik anahtarı yoktur. Zaten aktif olan bir adres için isteğin tekrarlanması güvenli ve ücretsizdir (2001), ancak yepyeni aynı adres için yapılan iki eşzamanlı istek de işleme alınabilir. Kendi tarafınızda adres başına aktivasyonu sıralı (seri) hale getirin.
• orderId biçimi A + rakamlardır ve aktivasyonlar arasında benzersizdir.
• Günümüzde aktivasyon için webhook gönderilmemektedir — yanıt ve hash doğrulamadır. Webhook'lar şu anda yalnızca onaylanmış Energy delegasyonlarını kapsar, bkz. Webhook'lar.