Integration Genel Bakış

Integration servisi platformun partner API'sidir. Her çağrı, çağrıyı iletmeden önce route'u, token'ınızı ve izinlerini kontrol eden integration gateway üzerinden ulaşır; ardından servis client'ınızın kendi korumalarını uygular ve işlemi çalıştırır.

Temel URL'ler

Ortam	Temel URL
Test	https://test-integration-api.tokenizationtr.com
Prodüksiyon	https://integration-api.tokenizationtr.com

Endpoint grupları

Önek	Kapsam
/v2/oauth/token	Token verme. Bkz. Token Oluşturma
/v2/admin/**	Arzın işletilmesi: düğümler, kurulumlar ve kontratlar, cüzdanlar, token'lar, KYC, ücretler, para birimi token'ları, OTC ve OTC kuralları, kategoriler, oracle'lar ve oracle metrikleri, sahiplik değişiklikleri, platform sahibi ayarları, custody / spot fiyat / AI sağlayıcı ayarları, supervisor'lar ve analizler. Token'ları Getir ile başlayın
/v2/users/**	Yatırımcılara hizmet: kullanıcılar ve cüzdanları, taşıma, alımlar, OTC, ikincil piyasa, kira, yakma ve para çekme. Kullanıcı Token'larını Getir ile başlayın
/v2/chains, /v2/networks, /v2/gas-sponsor-wallets, /v2/blockchain/gas-fee	Admin ve kullanıcı akışlarının paylaştığı zincir referans verisi
/v2/distributions/**	Dağıtım token'ı okumaları
/v2/webhooks/custodial	Gelen custody webhook'ları (yalnızca custody sağlayıcıları). Bkz. Custody Webhook'u Alma
/v2/mcp	MCP etkin client'lar için Model Context Protocol aktarımı

/v1/owners/**, platformun owner kurulumlarıyla arka kanalıdır ve partner API'sinin parçası değildir.

Kimlik doğrulama ve korumalar

Her /v2/admin/**, /v2/users/**, zincir referans ve dağıtım çağrısı, Token Oluşturma ile alınan bir Authorization: Bearer <access_token> gerektirir (client_credentials, password ya da refresh_token grant'ı). Çağrı ardından sırasıyla şunlardan geçer:

1. Gateway: route izin listesinde (değilse 404) ve token route'un iznini taşıyor (değilse 403).
2. Token: geçerli, süresi dolmamış, refresh token değil ve hâlâ client'ınızın geçerli access token'ı (değilse 401). Yeni bir token istemek öncekini geçersiz kılar.
3. Client sertifikası: client'ınız sertifika gerektiriyorsa, TLS el sıkışmasında ona verilen sertifika sunulmuş (401). Bkz. mTLS Client Sertifikaları.
4. IP izin listesi: liste boş değilse çağıranın adresi client'ınızın allowed_ips listesinde (401).
5. Hız sınırı: saniye / dakika / saat başına (429, kod 10011).
6. Aylık kullanım sınırı: bkz. Kullanım / Skor (429, kod 10012).

Kurallar

• Id'ler 24 karakterlik hex string'lerdir. Hatalı biçimli bir id 400, kod 10016 ile reddedilir.
• Tutarlar ve yüzdeler ondalık string'lerdir ("12.5"); tam token adetleri JSON number olarak kalır. Bkz. Tutarlar ve Yüzdeler.
• Listelemeler query string'de page (≥ 1) ve per_page (1–100) alır ve {"data": [...], "total": n, "page": p, "per_page": pp} döner. Hiçbir kayıtla eşleşmeyen bir filtre 404 değil, boş bir sayfa döner.
• Cüzdan ve ağ her zaman sizin seçiminizdir. Zincir üzerinde imza atan her işlem bir wallet_id ve ait olduğu network_id değerini alır (ya da bunları üzerinde çalıştığı kayıttan, örneğin bir listeleme ya da OTC teklifinden okur). Platform sizin yerinize cüzdan seçmez ya da ağ türetmez; bunlar olmadan gelen istek reddedilir.
• Zaman damgaları UTC cinsinden ISO 8601'dir.

Asenkron işlemler

Deploy, mint, yakma, kira dağıtımı, OTC kabul/iptal, ikincil piyasa ve alım sonuçlandırmaları, para çekme ve benzeri zincir üzerindeki işlemler 200 ile kabul edilir ve arka planda çalışır. Bu endpoint'lerin her biri, durumu nihai olana (3 done ya da 4 error) kadar sorgulayacağınız bir transaction döner ya da oluşturur; endpoint sayfası sorgulanacak okumayı belirtir. Kabulden sonraki bir başarısızlık HTTP hatası olarak değil, transaction üzerinde bildirilir. Platform sisteminizi geri çağırmaz.

Hatalar

Token endpoint'i dışındaki tüm endpoint'ler hataları {"code", "domain", "message"} biçiminde, doğrulama hatalarında ek olarak details ile döner. Bkz. Hatalar.

Postman koleksiyonu

Tüm partner endpoint'lerini içeren, içe aktarılmaya hazır Postman koleksiyonunun bağlantısı Giriş sayfasındadır.