Ana içeriğe geç

API Kullanım Skorları

Her API endpoint'inin kullanım skorları aşağıda detaylı olarak listelenmiştir. Her istek, belirli bir skor tüketir ve toplam anlaşmanıza bağlı olarak kullanılabilir skorunuz vardır.

Skor Sistemi​

Skor Hesaplama​

  • Her API isteği belirli bir skor tüketir
  • Skorlar endpoint'e göre değişir
  • Toplam skorunuz anlaşmanıza bağlıdır

Endpoint Skorları​

Authentication Endpoints​

EndpointMethodSkorAçıklama
/v2/auth/clientsPOST1000Client oluştur
/v2/auth/tokensPOST1000Token oluştur

Category Endpoints​

EndpointMethodSkorAçıklama
/v2/admin/categories/{category_id}GET0Kategori bilgilerini getir
/v2/admin/categories/rootGET0Kök kategorileri getir
/v2/admin/categories/{category_id}/childrenGET1000Alt kategorileri getir

Fee Endpoints​

EndpointMethodSkorAçıklama
/v2/fees/nodes/{node_id}POST1000Node fee oluştur
/v2/fees/nodes/{node_id}/platformPOST1000Node platform fee oluştur
/v2/fees/platformPOST1000Platform fee oluştur
/v2/fees/nodes/{node_id}GET1000Node fee getir
/v2/fees/nodes/{node_id}/platformGET1000Node platform fee getir
/v2/fees/platformGET1000Platform fee getir
/v2/fees/nodes/{node_id}PUT1000Node fee güncelle
/v2/fees/nodes/{node_id}/platformPUT1000Node platform fee güncelle
/v2/fees/platformPUT1000Platform fee güncelle

Node Endpoints​

EndpointMethodSkorAçıklama
/v2/admin/nodePOST1000Node oluştur
/v2/admin/node/{node_id}DELETE1000Node sil
/v2/admin/node/{node_id}/deploy-contractPOST1000Kontrat deploy et
/v2/admin/node/{node_id}/childrenGET1000Alt node'ları getir
/v2/admin/node/{node_id}/contract-statusGET1000Kontrat durumunu getir
/v2/admin/node/{node_id}GET0Node bilgilerini getir
/v2/admin/node/rootGET1000Kök node'ları getir
/v2/admin/node/{node_id}/wallet-summaryGET1000Wallet özetini getir
/v2/admin/node/{node_id}PUT1000Node güncelle

Supervisor Endpoints​

EndpointMethodSkorAçıklama
/v2/admin/supervisor/nodes/{node_id}GET1000Node supervisor'ını getir

Token Endpoints (Admin)​

EndpointMethodSkorAçıklama
/v2/admin/token/{token_id}/burnPOST1000Token yak
/v2/tokensPOST1000Token oluştur
/v2/admin/token/{token_id}DELETE1000Token sil
/v2/admin/token/{token_id}/delistPOST1000Token'ı delist et
/v2/admin/token/{token_id}/transactionsGET1000Token işlemlerini getir
/v2/admin/token/{token_id}GET0Token bilgilerini getir
/v2/tokensGET1000Token'ları getir
/v2/admin/token/{token_id}/listPOST1000Token'ı listele
/v2/admin/token/{token_id}/otcPOST1000Token'ı OTC'ye aç
/v2/admin/token/{token_id}/secondary-marketPOST1000Token'ı ikincil pazara aç
/v2/admin/token/{token_id}/passivePOST1000Token'ı pasif yap
/v2/admin/token/{token_id}/public-transferPOST1000Token'ı public transfer yap
/v2/admin/token/{token_id}/rentPOST1000Token'ı kiralama yap
/v2/admin/token/{token_id}/metricsPUT1000Token metriklerini güncelle
/v2/admin/token/{token_id}PUT1000Token güncelle

User Endpoints​

EndpointMethodSkorAçıklama
/v2/users/{user_id}GET0Kullanıcı bilgilerini getir
/v2/users/{user_id}PUT1000Kullanıcı güncelle
/v2/users/{user_id}/walletPUT1000Kullanıcı wallet güncelle

Purchases Endpoints​

EndpointMethodSkorAçıklama
/v2/users/purchases/users/{user_id}/group-searchPOST2000Satın alma gruplarını ara
/v2/users/purchases/users/{user_id}/searchPOST1000Satın alma işlemlerini ara
/v2/users/purchases/users/{user_id}/tokens/{token_id}/quantityGET1000Token miktarını getir
/v2/users/purchases/users/{user_id}/tokens/{token_id}/buy-on-primary-marketPOST1000Birincil pazardan satın al
/v2/users/purchases/users/{user_id}/tokens/{token_id}/buy-on-secondary-marketPOST1000İkincil pazardan satın al

Secondary Markets Endpoints​

EndpointMethodSkorAçıklama
/v2/users/secondary-markets/users/{user_id}/group-searchPOST2000İkincil pazar gruplarını ara
/v2/users/secondary-markets/users/{user_id}/tokens/{token_id}POST1000İkincil pazar anlaşmalarını getir
/v2/users/secondary-markets/users/{user_id}/tokens/{token_id}/sellPOST1000İkincil pazarda sat
/v2/users/secondary-markets/users/{user_id}/tokens/{token_id}/delistPOST1000İkincil pazardan kaldır

OTCs Endpoints​

EndpointMethodSkorAçıklama
/v2/users/otcs/users/{user_id}/group-searchPOST2000OTC gruplarını ara
/v2/users/otcs/users/{user_id}/tokens/{token_id}POST1000OTC anlaşmalarını getir
/v2/users/otcs/users/{user_id}/tokens/{token_id}/sellPOST1000OTC'de sat
/v2/users/otcs/users/{user_id}/tokens/{token_id}/cancelPOST1000OTC anlaşmasını iptal et

Token Endpoints (User Operations)​

EndpointMethodSkorAçıklama
/v2/admin/token/users/searchPOST1000Token ara
/v2/admin/token/users/{token_id}GET0Token bilgilerini getir
/v2/admin/token/users/{token_id}/users/{user_id}/burnPOST1000Kullanıcı token'ını yak

Admin OTCs Endpoints​

EndpointMethodSkorAçıklama
/v2/admin/otcs/nodes/{node_id}/group-searchPOST2000Admin OTC gruplarını ara
/v2/admin/otcs/nodes/{node_id}/tokens/{token_id}POST1000Admin OTC anlaşmalarını getir
/v2/admin/otcs/nodes/{node_id}/tokens/{token_id}/deals/{deal_id}/acceptPOST1000Admin OTC anlaşmasını kabul et
/v2/admin/otcs/nodes/{node_id}/tokens/{token_id}/deals/{deal_id}/cancelPOST1000Admin OTC anlaşmasını iptal et

Skor Kategorileri​

0 Skor - Ücretsiz Endpoint'ler​

  • Temel bilgi getirme işlemleri
  • Sık kullanılan, hafif işlemler
  • Toplam: 4 endpoint

1000 Skor - Standart Endpoint'ler​

  • Normal CRUD operasyonları
  • Tek kayıt üzerinde işlem yapan endpoint'ler
  • Basit veri işleme işlemleri
  • Toplam: 40+ endpoint

2000 Skor - Group Search Endpoint'ler​

  • Karmaşık arama ve filtreleme işlemleri
  • Büyük veri setleri üzerinde işlem
  • Çoklu veritabanı sorguları gerektiren işlemler
  • Toplam: 4 endpoint

Skor Yönetimi​

Toplam Skor​

  • Anlaşmanıza göre belirlenen aylık toplam skorunuz vardır
  • Bu skor tüm endpoint'ler için ortak kullanılır
  • Skor tükendiğinde API erişimi kısıtlanır

Skor Takibi​

  • Her istek sonrası kalan skorunuz güncellenir
  • Skor durumunuz API yanıtlarında belirtilir
  • Aylık skorunuz yenilenir

Örnek Hesaplama​

Aylık Skorunuz: 100,000

Günlük Kullanım:

  • 5 Group Search isteği: 5 × 2000 = 10,000 skor
  • 20 Standart endpoint isteği: 20 × 1000 = 20,000 skor
  • 10 Ücretsiz endpoint isteği: 10 × 0 = 0 skor
  • Toplam Günlük: 30,000 skor
  • Kalan Skor: 70,000 skor

Skor Optimizasyonu​

Verimli Kullanım​

  • Group Search endpoint'lerini gereksiz yere kullanmayın
  • Ücretsiz endpoint'leri tercih edin
  • Veri filtreleme işlemlerini mümkün olduğunca istemci tarafında yapın

Öneriler​

  • Büyük veri setleri için sayfalama kullanın
  • Sık kullanılan verileri yerel olarak saklayın
  • Gereksiz istekleri önleyin

Hata Durumları​

Skor Tükendiğinde​

  • API istekleri 429 Too Many Requests hatası döner
  • Yeni aylık dönem başlayana kadar beklemelisiniz
  • Skor paketi yükseltme seçenekleri mevcuttur

Skor Kontrolü​

  • Her istek öncesi kalan skorunuzu kontrol edin
  • Kritik işlemler için yeterli skorunuz olduğundan emin olun
  • Skor kullanımınızı düzenli olarak takip edin