Ana içeriğe geç

Tokenizasyon API Dokümantasyonu

Bu, Apex partner API'sinin dokümantasyonudur: sistemlerinizin gerçek dünya varlıklarını tokenize ettiği, pazarlarını işlettiği ve yatırımcılarınıza hizmet verdiği integration API'si.

Genel Bakış​

Platform, gerçek dünya varlıklarını zincir üzerindeki token'lar olarak temsil eder. Partner API üzerinden client'ınız:

  • Arzı işletir (/v2/admin/**): düğümler ve kontrat kurulumları, token'lar ve yaşam döngüleri (listeleme, kira, yakma, OTC ve ikincil piyasaya açma), KYC token'ları, grupları ve token bazlı kurallar, ücretler, para birimi token'ları, kategoriler, oracle'lar, sahiplik değişiklikleri ve analizler.
  • Yatırımcılara hizmet verir (/v2/users/**): kullanıcıları ekler ve taşır, cüzdanlarını yönetir ve alım, satım, OTC işlemi, ikincil piyasada listeleme, kira tahsili ve para çekme yapmalarını sağlar.
  • Zincir referans verisini okur (/v2/chains, /v2/networks, /v2/gas-sponsor-wallets, /v2/blockchain/gas-fee) ve dağıtım verisini okur (/v2/distributions/**).

Temel Özellikler​

  • Varlık tokenizasyonu: Seçtiğiniz ağda kontrat kurulumlarını deploy edin ve gerçek dünya varlıkları için token çıkarın.
  • Token yaşam döngüsü: Listeleme, listeden çıkarma, kira, yakma, yeniden tokenize etme, OTC'ye ve ikincil piyasaya açma.
  • KYC ve uyum: Ağ başına KYC token'ları, gruplar, beyaz listeler, kara listeler ve dağıtım listeleri.
  • Çok cüzdanlı yatırımcılar: Bir kullanıcının birden fazla cüzdanı olabilir; cüzdana bağlı her işlem çalıştığı wallet_id ve network_id değerini belirtir.
  • Kesin tutarlar: Fiyatlar, ücretler ve bakiyeler ondalık string olarak taşınır. Bkz. Tutarlar ve Yüzdeler.
  • Asenkron zincir işleri: Zincir üzerindeki işlemler hemen kabul edilir ve arka planda sonuçlanır; bunları transaction kayıtlarını sorgulayarak izlersiniz.
  • Client bazlı korumalar: İzinler, IP izin listesi, hız sınırları, aylık kullanım kotası ve isteğe bağlı mTLS client sertifikaları.

Kimlik Doğrulama​

API, OAuth 2.0 bearer token kullanır.

  1. Platform operatörü sizin için bir API client'ı oluşturur (bkz. Client Oluşturma).
  2. client_id / client_secret bilgilerinizi client_credentials grant'ı ile (ya da bir supervisor'ın username / password bilgilerini password grant'ı ile) Token Oluşturma üzerinden bir access token ile değiştirin.
  3. Access token'ı her çağrıda gönderin:
Authorization: Bearer <access_token>

Bir client'ın aynı anda tek bir geçerli access token'ı vardır: yeni bir token istemek öncekini geçersiz kılar. Refresh token'lar tek kullanımlıktır. Hatalar tek bir biçimi izler.

API Adresleri​

Test Ortamı​

https://test-integration-api.tokenizationtr.com

Prodüksiyon Ortamı​

https://integration-api.tokenizationtr.com

Postman Koleksiyonu​

Postman koleksiyonu, partner API'sinin tüm endpoint'lerini örnek gövdeler ve açıklamalarla içerir.

📥 Postman Koleksiyonunu İndir

Talimatlar:

  1. Koleksiyonu indirin ve Postman'e içe aktarın.
  2. Çağırdığınız platformun ortam dosyasını içe aktarın:
  3. Ortamda clientId ve clientSecret değerlerini (password grant kullanıyorsanız username / password değerlerini de) doldurun.
  4. Authentication → Get Token (Client Credentials) ya da Get Token (Password) isteğini çalıştırın. İstek token ve refreshToken değerlerini ortama kaydeder; diğer tüm istekler token değerini otomatik kullanır.
  5. Koleksiyonda path değişkenleri ve id'ler bilinçli olarak boş bırakılmıştır: kendi verinizle doldurun.