/v1 altında sürümlenir.
Erişim alma
Erişim proje bazında verilir. Dördüne birden ihtiyacınız var:Aktif bir üyelik, Silver veya üzeri
Onaylanmış bir geliştirici başvurusu
Kabul edilmiş API Geliştirici Şartları
Projenizin ihtiyaç duyduğu scope'lar
Scope’lar
Kimlik doğrulama
Gizli anahtarınızı Bearer token olarak gönderin:- IP izin listesi — çağrıları belirli sunucu IP’leriyle sınırlar
- Hız limitleri — sahibin üyelik seviyesiyle birlikte yükselen proje bazlı tavanlar
Anahtarlar, döndürme ve saklama
- Yalnızca sunucu tarafında tutun — anahtarı elinde tutan herkes kullanıcılarınızdan tahsilat yapabilir
- API anahtarları sekmesinden döndürün. Önceki anahtar 24 saatlik bir tolerans süresi boyunca çalışmaya devam eder, böylece kesintisiz dağıtım yapabilirsiniz
- Webhook imza gizli anahtarı ayrı döndürülür ve kendi 24 saatlik örtüşmesi vardır
- Sızarsa hemen döndürün
Bir kullanıcıdan tahsilat
Uygulamanız POST /v1/deduct çağırır
guildId ve ürün ayrıntılarıyla.Vito bir confirmUrl döner
Kullanıcı PIN'iyle onaylar
vetox.io üzerinde.Vito mahsuplaşır ve bildirir
Uygulamanız doğrular ve tamamlar
İstek parametreleri — /v1/deduct
Bir kullanıcıya alacak kaydetme
POST /v1/add, bir kullanıcıya kendi bakiyenizden Vito ekler — ödüller veya iadeler için. guildId ve product dışında /deduct ile aynı alanlar.
credit:create scope’unu ve yeterli bakiyeyi gerektirir; aksi hâlde çağrı 402 VITO_INSUFFICIENT_OWNER_FUNDS döner.Ücretler
Her tahsilat, platform ücreti düşülerek size aktarılır — uygulama içi Vito transferleriyle aynı tarife üzerinden ve sizin üyelik seviyenize göre:/v1/add üzerinden yapılan alacak kayıtları ise her zaman ücretsizdir.Webhook’lar
Ayarlar sekmesinde bir veya daha fazlahttps geri çağırma adresi ekleyin. Bir onay nihai duruma ulaştığında Vito imzalı bir POST gönderir.
İmzayı doğrulama
Her teslimat birX-Vito-Signature başlığı taşır:
X-Vito-Event-Id’yi yineleme önleme anahtarı olarak kullanın, çünkü yeniden deneme aynı kimliği tekrar gönderir:
<ts>:<rawBody> üzerinden imza gizli anahtarınızla yeniden hesaplayın ve sabit sürede karşılaştırın.
Olaylar
Beş olay türü, hepsi aynı yük yapısını paylaşır. Sonucudata.status taşır.
Hata kodları
Her yanıt bir zarf içindedir. Başarıdata, hata ise error taşır; ikisi birden asla olmaz:
Hız limitleri
Idempotency-Key başlığı gönderin.Uç noktalar
Sınırlar
- Onaylar 10 dakika sonra sona erer — onaylanmamış talepleri terk edilmiş sayın
amountpozitif bir tam sayı olmalıdırmetadata10 anahtarla sınırlıdır- İşlem başına ve günlük tavanları Vetox ekibi belirler; ayarlar sekmesinde salt okunur görünür
Güvenlik kontrol listesi
Gizli anahtarları sunucuda tutun
Gizli anahtarları sunucuda tutun
Her webhook'u doğrulayın
Her webhook'u doğrulayın
Yalnızca completed üzerine mahsuplaşın
Yalnızca completed üzerine mahsuplaşın
/deduct yanıtına dayanarak teslim etmeyin — tahsilat ancak confirmation.completed ile kesinleşir.En az ayrıcalık
En az ayrıcalık
Sorun giderme
Her çağrı yetkisiz dönüyor
Her çağrı yetkisiz dönüyor
Anahtarımı kaybettim
Anahtarımı kaybettim
Döndürmeden sonra webhook imzaları başarısız oluyor
Döndürmeden sonra webhook imzaları başarısız oluyor
Bir tahsilat hiç tamamlanmıyor
Bir tahsilat hiç tamamlanmıyor
Hiç webhook gelmiyor
Hiç webhook gelmiyor
Tahsil ettiğimden daha az Vito geldi
Tahsil ettiğimden daha az Vito geldi
402 VITO_INSUFFICIENT_OWNER_FUNDS
402 VITO_INSUFFICIENT_OWNER_FUNDS
/v1/add kendi bakiyenizden finanse edilir, yoktan yaratılmaz. Bakiyenizi yükleyin.