POST /apiv2/reports/statement

Bir hesap özeti dosyası sipariş edin — belirli bir dönem boyunca tek bir token'a ait tüm işlemler, CSV veya PDF olarak. Dosya arka planda oluşturulur: istek hemen bir sipariş numarası döndürür ve dosya hazır olduğunda alınır.

Aynı veriye beklemeden hızlıca göz atmak için bunun yerine hesap özeti önizlemesini kullanın — anında yanıt verir ancak döndürdüğü işlem sayısını sınırlandırır.

Uç Nokta Temel URL'si

https://netts.io/apiv2/reports

İstek Üstbilgileri

Header	Zorunlu	Açıklama
X-API-KEY	evet	Kontrol panelinden alınan API anahtarı
X-Real-IP	evet	Anahtar beyaz listesindeki bir adres
X-Idempotency-Key	hayır	Kendi anahtarınız, A-Z a-z 0-9 . _ : - karakterlerinden oluşan 12–128 karakter

Dosya siparişi verme

curl -s -X POST 'https://netts.io/apiv2/reports/statement' \
  -H 'X-API-KEY: your-api-key' \
  -H 'X-Real-IP: 203.0.113.10' \
  -H 'Content-Type: application/json' \
  -d '{
        "client_request_id": "stmt-2026-09-usdt",
        "address": "TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "token_id": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
        "date_from": "2026-09-01",
        "date_to": "2026-09-30",
        "format": "csv"
      }'

{
  "status": "success",
  "code": 0,
  "msg": "created",
  "data": {
    "order_no": "REPxxxxxxxxxxxx",
    "client_request_id": "stmt-2026-09-usdt",
    "type": "statement",
    "status": "queued",
    "quota_bucket": "free",
    "progress_pct": 0,
    "address": "TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "token_id": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
    "date_from": "2026-09-01",
    "date_to": "2026-09-30",
    "format": "csv",
    "created_at": "2026-09-06 17:01:51.868542+00:00",
    "finished_at": null,
    "expires_at": null,
    "artifact_sha256": null,
    "artifact_size": null,
    "download_url": null
  }
}

Alan	Zorunlu	Notlar
client_request_id	evet	Tanımlayıcınız. Hesap başına benzersiz
address	evet	TRON base58, 34 karakter
token_id	hayır	Varsayılan olarak TRX; bir TRC20 sözleşmesi veya bir TRC10 kimliği
date_from, date_to	evet	UTC, dahil. En fazla 366 gün
format	hayır	Varsayılan olarak csv. PDF 5000 işlemle sınırlıdır

Ardından hazırlanmasını bekleyin

curl -s 'https://netts.io/apiv2/reports/REPxxxxxxxxxxxx' \
  -H 'X-API-KEY: your-api-key' -H 'X-Real-IP: 203.0.113.10'

status alanı sırasıyla queued → running → waiting_cypherarc → done aşamalarından geçer. İki durum daha son durumdur: error_code ve error_message alanlarında nedeni belirtilen error ve dosyanın süresi dolduğunda expired. Kısa bir hesap özeti genellikle bir dakikadan çok daha kısa sürede hazır olur; done dışındaki tüm durumları "beklemeye devam et" olarak değerlendirin.

Durum done olduğunda, download_url doldurulur — tam bir URL olarak değil, bir yol olarak — ve dosya indirilebilir:

curl -s -OJ 'https://netts.io/apiv2/reports/REPxxxxxxxxxxxx/download' \
  -H 'X-API-KEY: your-api-key' -H 'X-Real-IP: 203.0.113.10'

Dosya gzip ile sıkıştırılmış olarak gelir. Bir CSV siparişi, Content-Disposition başlığında bir .csv.gz dosya adı ile application/gzip olarak indirilir; ayrıştırmadan önce sıkıştırmayı açın. Durum yanıtı, tam olarak teslim edilen sıkıştırılmış dosya için artifact_sha256 ve artifact_size değerlerini taşır, böylece indirmeyi ikinci bir istek yapmadan doğrulayabilirsiniz.

Sürekli sorgulamak (polling) yerine bir webhook kaydedin ve dosya hazır olduğunda bildirim alın.

İsteği tekrarlamak güvenlidir

Aynı client_request_id veya aynı X-Idempotency-Key değerini gönderdiğinizde, ikinci bir sipariş oluşturulmak yerine mevcut siparişi geri alırsınız. İkisini birbirinden ayırt edebilmeniz için yanıt "msg": "existing" bilgisini taşır.

Bir tanımlayıcıyı farklı bir gövde ile yeniden kullanmak yeni bir sipariş değil, bir hatadır: bu durum 409 hatası verir. Tanımlayıcılar yalnızca sizin hesabınız içinde benzersizdir — başka bir hesabın tanımlayıcıları asla sizinkiyle çakışmaz.

Dosyalar 30 gün boyunca saklanır

Bu sürenin ardından sipariş expired durumuna geçer ve indirme işlemi 410 sonucunu verir. Daha sonra ihtiyacınız olursa tekrar sipariş verin.

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

Tüm istemciler arasında paylaşılan, uç nokta başına saniyede 10 istek. Bu sınırın aşılması, Retry-After: 1 başlığı ve Endpoint rate limit exceeded (10 req/s shared) mesajı ile birlikte 429 hatası verir.

Tek sınır budur. Aylık kota, kaç dosya sipariş edebileceğinize dair bir tavan sınır veya aynı anda kaç tanesinin oluşturulabileceğine dair bir sınır yoktur — pozitif bakiyeye sahip bir hesap, hız sınırının izin verdiği ölçüde sipariş verebilir. Oluşturma kuyruğunun alabileceğinden fazla olan siparişler reddedilmek yerine bekletilir ve otomatik olarak yeniden denenir, bu nedenle ani istek artışları size hata olarak değil, gecikme süresi olarak yansır.

Hatalar

HTTP	Anlamı
400	adres 34 karakter uzunluğunda ancak base58 sağlama toplamı geçersiz
401	anahtar eksik veya geçersiz ya da kaynak IP beyaz listede değil
402	hesap bakiyesi 4 TRX minimum sınırının altında
403	API anahtarı engellenmiş; destek ile iletişime geçin
409	aynı tanımlayıcı farklı bir gövde ile kullanıldı — gövde IDEMPOTENCY_CONFLICT şeklindedir
410	dosyanın süresi doldu
422	bir alan eksik veya hatalı biçimlendirilmiş ya da süre 366 günü aşıyor
429	hız sınırı aşıldı — Retry-After süresinden sonra tekrar deneyin

İlgili

• Bakiyeler — bakiyeleri okuma ve anlık hesap özeti önizlemesi
• Rapor webhook'ları — bir dosya hazır olduğunda bildirim alma