Activator — adres etkinleştirme

Zincir üzerinde daha önce hiç kullanılmamış bir TRON adresini etkinleştirin. Tamamen yeni bir adresin hesap kaydı bulunmaz, bu nedenle etkinleştirilene kadar delege edilmiş Energy veya Bandwidth alamaz. Bu uç nokta hesabı sizin yerinize oluşturur ve etkinleştirme işlem özetini (transaction hash) döndürür.

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

Uç Nokta Taban URL'si

https://netts.io/apiv2/activator

İstek Üstbilgileri

Header	Required	Description
Content-Type	Yes	application/json
X-API-KEY	Yes	Netts kontrol panelinizdeki API anahtarınız

user_id bilginiz API anahtarından türetilir — bunu asla siz iletmezsiniz.

Etkinleştir — `POST /apiv2/activator`

İstek Gövdesi

json

{ "targetAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE" }

Parameter	Type	Required	Description
`targetAddress`	string	Yes	Etkinleştirilecek TRON adresi. `^T[A-Za-z0-9]{33}$` ile eşleşmelidir (34 karakter, `T` ile başlar).

Response — etkinleştirildi (200, kod `10000`)

json

{
    "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	Etkinleştirme sipariş numarası, her zaman `A` + rakamlardan oluşur. Mutabakat için kullanın.
`targetAddress`	string	Etkinleştirilen 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	Etkinleştirme işlem özeti (transaction hash). Herhangi bir TRON gezgininde doğrulayın.

Response — zaten etkin (200, kod `2001`)

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

json

{
    "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 kesintisi yapıldığını varsaymadan önce code değerini kontrol edin: 10000 ödeme yaptığınız, 2001 ise yapmadığınız anlamına gelir.

Örnekler

bash

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

Fiyat

Öğe	Tutar
Etkinleştirme	1.1 TRX
Adres zaten etkin	0

Tutar sabittir; adrese veya ağ koşullarına bağlı olarak değişmez. Etkinleştirme başarılı olduğu anda Netts bakiyenizden düşülür — asla daha önce değil. Başarısız bir etkinleştirme hiçbir ücrete tabi değildir.

Bakiyeniz 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 delegasyon başarısız olur. Önce etkinleştirin, 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 etkindir ve çağrı yalnızca 2001 döndürür.

Yeni bir adres için Energy siparişi verme

1 saatlik Energy uç noktası, siparişin bir parçası olarak etkin olmayan bir alıcıyı kendiliğinden etkinleştirir ve etkinleştirme maliyeti bu siparişe eklenir. Adresin herhangi bir kiralamadan önce etkin olmasını istediğinizde — örneğin, etkin bir hesap gerektiren Bandwidth yüklemesini önce yapmak için — etkinleştiriciyi açıkça çağırın.

Zamanlama

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

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

Hata Kodu Referansı

Code	Description	HTTP Durumu
`10000`	Adres etkinleştirildi, bakiye düşüldü	200
`2001`	Adres zaten etkinleştirilmiş, ücret alınmadı	200
`-1`	Geçersiz API anahtarı / IP beyaz listede değil	401
`1004`	Yetersiz bakiye — mesaj ne gerektiğini ve neye sahip olduğunuzu belirtir	403
`-`	Geçersiz `targetAddress` biçimi (34 karakter olmalı, `T` ile başlamalıdır)	422
`5003`	Etkinleştirme başarısız oldu veya hizmet geçici olarak kullanılamıyor — daha sonra tekrar deneyin	503
`5000`	Sunucu içi hata	500

Bir 503 yanıtı, hiçbir ücret alınmadığı ve hiçbir adresin etkinleştirilmediği anlamına gelir: istek güvenle yeniden denenebilir.

İstek Hızı Sınırları

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

Dönem	Sınır
1 saniye	5 istek
1 dakika	60 istek

İstek Sınırı Aşıldı (429)

json

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

Faturalı (Postpaid) Hesaplar

Faturalı ödeme modelindeki hesaplar aynı uç noktayı, üstbilgileri ve istek gövdesini kullanır. Fark, etkinleştirmenin nasıl ödendiğidir:

Depozitonuzdan hiçbir şey düşülmez. Başarılı her etkinleştirme, sözleşmenizde kararlaştırılan ödeme para birimi cinsinden vadesi gelen hesap bakiyenize eklenir. Sözleşmenize göre fatura karşılığı ödersiniz.
Hesabınızın bir kredi limiti vardır. Ödenmesi gereken tutar limit dahilinde olduğu sürece, sıfır depozitoda dahi etkinleştirmeler kabul edilir.
Yalnızca tamamlanan bir etkinleştirme faturalandırılır. Zaten etkin olan bir adres (2001) ve başarısız bir etkinleştirme hiçbir maliyet oluşturmaz.

Faturalı ödeme, talep üzerine bir hesap için Netts tarafından etkinleştirilir. Her yanıt etkinleştirmenin nasıl ödendiğini belirtir: paymentMode değeri postpaid veya prepaid şeklindedir.

Ek istek alanları

Parameter	Type	Required	Description
`test`	boolean	No	`true` — yalnızca fiyatı hesaplar ve adresi kontrol eder. Hiçbir şey etkinleştirilmez veya faturalandırılmaz
`freezePrice`	boolean	No	`true` — sözleşmeniz kapsamındaki fiyatı 60 saniye boyunca sabitler. Hiçbir şey etkinleştirilmez veya faturalandırılmaz
`quoteId`	string	No	Aynı adres için `freezePrice` tarafından düzenlenen bir teklifin fiyatından etkinleştirin
`priceCurrency`	string	No	`TRX` (varsayılan) veya `settlement.asset` içinde belirtilen sözleşmenizin para birimi. Faturalı hesaplar için sözleşme para biriminizdeki tutarlar her zaman dahil edilir

quoteId, test veya freezePrice ile birleştirilemez. İstek gövdesindeki diğer tüm alanlar reddedilir.

Fiyat kontrolü (`test: true`)

json

{ "targetAddress": "TSMARToKjQGxroMnPKK6o6d4876VkQmHEH", "test": true }

json

{
    "detail": {
        "code": 10010,
        "msg": "Test calculation",
        "data": {
            "amount": 1,
            "unitPriceSun": null,
            "discount": null,
            "energyTRX": "0.000000",
            "activationTRX": "1.100000",
            "wouldCostTRX": "1.100000",
            "paidTRX": 0,
            "paymentMode": "postpaid",
            "activationCheck": "inactive",
            "alt": {"USDC": {"energy": "0.000000", "activation": "0.364333", "total": "0.364333"}},
            "fxAt": "2026-10-19T07:17:33.475335+00:00",
            "targetAddress": "TSMARToKjQGxroMnPKK6o6d4876VkQmHEH"
        }
    }
}

activationCheck: inactive — adresin etkinleştirilmesi gerekir ve faturalandırılacaktır; active — adres zaten etkindir, wouldCostTRX değeri 0 olur; unknown — şu anda kontrol edilemedi.

alt.<currency> — sözleşmenizin para birimindeki aynı tutarlar. fxAt — kullanılan döviz kurunun zamanı.

Sabit fiyat teklifi (`freezePrice: true`)

İsteği "freezePrice": true ile gönderin. Yanıt, 10011 koduna (Quote issued), bir fiyat kontrolüyle aynı alanlara ve ek olarak quoteId ile expiresAt alanlarına sahiptir.
60 saniye içinde isteği "quoteId": "<quoteId>" ve aynı targetAddress ile gönderin.
Etkinleştirme teklif edilen fiyattan — teklif anında sözleşmeniz kapsamındaki fiyattan — faturalandırılır.

Bir teklif bir kez kullanılabilir. Süresi dolmuş veya zaten kullanılmış bir teklif reddedilir ve hiçbir şey etkinleştirilmez.

Başarılı etkinleştirme

json

{
    "detail": {
        "code": 10000,
        "msg": "Address activated successfully, 1.1 TRX service cost, postpaid",
        "data": {
            "orderId": "A564125",
            "targetAddress": "TSMARToKjQGxroMnPKK6o6d4876VkQmHEH",
            "activation_cost": 1.1,
            "user_balance_before": 0.0,
            "user_balance_after": 0.0,
            "hash": "bd9ea6ef92ce4ba6553af3930a03abe874cdfcc2399b7fdd9abdb11570de2920",
            "paymentMode": "postpaid",
            "activationTRX": "1.100000",
            "totalTRX": "1.100000"
        }
    }
}

Parameter	Description
`activation_cost`	Etkinleştirmenin TRX cinsinden maliyeti. Faturalı hesaplar için depozitodan düşülmez
`user_balance_before` / `user_balance_after`	Depozitonuz — faturalı hesaplar için değişmez
`paymentMode`	`postpaid`
`activationTRX` / `totalTRX`	Kesin tutarlar, 6 ondalık basamak
`quoteId`, `alt`	Etkinleştirme bir teklif ile yapıldığında mevcuttur

Kredi limitine ulaşıldı (402)

json

{
    "detail": {
        "code": 1004,
        "msg": "Postpaid credit limit reached.",
        "paymentMode": "postpaid",
        "reason": "limit_reached"
    }
}

Hiçbir şey etkinleştirilmez ve hiçbir şey faturalandırılmaz. Ödemeniz kaydedildiğinde veya limitiniz artırıldığında yeni etkinleştirmeler tekrar kabul edilir.

Faturalı hata kodları

Code	HTTP	Description
`10010`	200	Fiyat kontrolü sonucu (`test`)
`10011`	200	Teklif düzenlendi (`freezePrice`)
`1004`	402	Faturalı kredi limitine ulaşıldı
`4100`	400	Geçersiz istek
`4101`	400	Desteklenmeyen `priceCurrency`
`4102`	400	`quoteId`, `test` veya `freezePrice` ile birleştirilmiş
`4103`	409	Teklif zaten kullanılmış
`4104`	409	Teklifin süresi dolmuş
`4106`	404	Teklif bulunamadı
`4107`	409	İstek parametreleri tekliften farklı
`4108`	400	Geçersiz `quoteId` biçimi
`4109`	422	Alt hesaplar için kullanılamaz
`5032`	503	Fiyat geçici olarak kullanılamıyor
`5033`	503	Döviz kuru geçici olarak kullanılamıyor
`5034`	503	Faturalandırma geçici olarak kullanılamıyor — etkinleştirme kabul edilmedi
`5036`	503	Kredi kontrolü geçici olarak kullanılamıyor — daha sonra tekrar deneyin

Yukarıdaki tüm 4xx ve 503 yanıtları için hiçbir şey etkinleştirilmez ve hiçbir şey faturalandırılmaz.

Notlar

Eşzamanlılık ve tekillik (idempotency) sizin sorumluluğunuzdadır. Uç noktanın bir idempotency key desteği yoktur. Zaten etkin olan bir adres için isteği tekrarlamak güvenli ve ücretsizdir (2001), ancak tamamen yeni aynı adres için yapılan iki eşzamanlı istek aynı anda işleme alınabilir. Kendi tarafınızda adres başına etkinleştirmeleri sıralı olarak yürütün.
orderId biçimi A + rakamlardan oluşur ve etkinleştirmeler genelinde benzersizdir.
Günümüzde etkinleştirme için hiçbir webhook gönderilmez — yanıt ve hash doğrulamayı sağlar. Webhook'lar şu anda yalnızca onaylanmış Energy delegasyonlarını kapsar, bkz. Webhooks.

Activator — adres etkinleştirme ​

Uç Nokta Taban URL'si ​

İstek Üstbilgileri ​

Etkinleştir — POST /apiv2/activator ​

İstek Gövdesi ​

Response — etkinleştirildi (200, kod 10000) ​

Response — zaten etkin (200, kod 2001) ​

Örnekler ​

Fiyat ​

Buna ne zaman ihtiyaç duyarsınız? ​

Zamanlama ​

Hata Kodu Referansı ​

İstek Hızı Sınırları ​

İstek Sınırı Aşıldı (429) ​

Faturalı (Postpaid) Hesaplar ​

Ek istek alanları ​

Fiyat kontrolü (test: true) ​

Sabit fiyat teklifi (freezePrice: true) ​

Başarılı etkinleştirme ​

Kredi limitine ulaşıldı (402) ​

Faturalı hata kodları ​

Notlar ​

Activator — adres etkinleştirme

Uç Nokta Taban URL'si

İstek Üstbilgileri

Etkinleştir — `POST /apiv2/activator`

İstek Gövdesi

Response — etkinleştirildi (200, kod `10000`)

Response — zaten etkin (200, kod `2001`)

Örnekler

Fiyat

Buna ne zaman ihtiyaç duyarsınız?

Zamanlama

Hata Kodu Referansı

İstek Hızı Sınırları

İstek Sınırı Aşıldı (429)

Faturalı (Postpaid) Hesaplar

Ek istek alanları

Fiyat kontrolü (`test: true`)

Sabit fiyat teklifi (`freezePrice: true`)

Başarılı etkinleştirme

Kredi limitine ulaşıldı (402)

Faturalı hata kodları

Notlar