SDK ve API

API errors

Error response format, validation, auth ve rate-limit hataları.

Son güncelleme: 22 Mayıs 20268-14 dkBaşlangıç ve orta seviye
Ücretsiz başla Paketleri görMetodoloji

Bu özellik ne işe yarar?

API errors, Testvoy içinde sdk ve api akışının karar vermeye hazır hale gelmesini sağlar. Amaç sadece ayarı bulmak değil; ekiplerin neyi neden yaptığını, sonucu nasıl okuyacağını ve hata olduğunda nereden başlayacağını bilmesidir.

Ne zaman kullanacağını bil

Ekranda hangi alanları göreceğini öğren

Başarılı olduğunu nasıl anlayacağını netleştir

API errors ekran akışı
SetupQARapor
Gerçek screenshot eklendiğinde bu frame ürün ekranıyla değiştirilebilir.

Ne zaman kullanılır?

Bu rehberi, ilk kurulumda, yeni bir deney hazırlarken, rapor yorumlarken veya müşteri/ekip paylaşımı öncesinde kontrol listesi gibi kullan. Testvoy’un sade yüzeyi teknik olmayan kullanıcıyı yönlendirirken geliştiriciye de event, SDK ve güvenlik bağlamını açık bırakır.

  1. 01

    İlgili workspace ve project’i seç

  2. 02

    Bu sayfadaki checklist’i uygula

  3. 03

    Preview veya verifier ile doğrula

  4. 04

    Raporu ya da ayarı ekip içinde paylaş

Nasıl yapılır?

Testvoy’da çoğu işlem aynı mantığı izler: önce bağlamı seç, sonra kuralı veya değişikliği tanımla, son olarak QA ve rapor tarafında sonucu doğrula. Bu yapı, ürünün test çalıştırmaktan çok karar kalitesine odaklanmasını sağlar.

  • Workspace doğru mu?
  • Project key veya domain doğru mu?
  • Goal/event eşleşiyor mu?
  • Mobile ve desktop ayrı kontrol edildi mi?
  • Bot/SRM veya dropped event uyarısı var mı?
API request
GET /v1/projects
X-Testvoy-Api-Key: TESTVOY_API_KEY

HTTP/1.1 200 OK
{
  "data": []
}

Örnek developer entegrasyonu

Örnek: Signup sonrası conversion event'i ve kullanıcı plan niteliği gönderilecek. Event tracking iş olayını ölçer, identify ise segmentation için müşteri niteliğini bağlar. Gereksiz kişisel veri göndermeden sade property kullan.

  1. 01

    SDK'nın yüklendiğini doğrula

  2. 02

    Signup success callback içinde track çağrısı yap

  3. 03

    Plan veya account_type gibi segment değerlerini identify ile gönder

  4. 04

    Recent events içinde accepted sinyali kontrol et

  5. 05

    Goal condition ile event adını birebir eşleştir

API request
GET /v1/projects
X-Testvoy-Api-Key: TESTVOY_API_KEY

HTTP/1.1 200 OK
{
  "data": []
}

Pratik senaryo

Bir growth ekibi pricing sayfasındaki CTA metnini değiştirir, signup_started ve signup_completed hedeflerini bağlar, Google Ads ve returning visitor segmentlerini ayrı okur. Sonuç olumluysa rapor linkini müşteri veya yönetimle paylaşır.

Sık yapılan hatalar

Hataların çoğu yanlış project key, fazla genel selector, eksik goal, staging/prod karışıklığı, küçük örneklemle erken karar veya mobile görünümü kontrol etmemekten çıkar.

Deneye 'test' gibi belirsiz ad vermek

Goal olmadan deney başlatmak

Sadece toplam CVR ile karar vermek

Shareable report yerine ekran görüntüsü göndermek

Sık sorulan sorular

API errors hangi ekipler için uygun?

Marketing, growth, product ve developer ekipleri aynı rehberi farklı derinlikte kullanabilir.

Bu işlem için developer gerekir mi?

Basit görsel değişiklikler ve rapor okuma için gerekmez; SDK, custom event, custom JS veya enterprise security konularında teknik destek faydalıdır.

Başarılı olduğunu nasıl anlarım?

Verifier, recent events, preview, QA checklist ve rapor uyarıları başarılı kurulum ve deney durumunu gösterir.

Sık hata nedir?

Yanlış project key, eksik goal, kırılgan selector, küçük örneklemle erken karar ve mobile QA eksikliği en sık görülen hatalardır.

Dokümanlar

Bu rehberi uygulamada dene

Kurulumu tamamla, ilk deneyini oluştur ve raporu Testvoy içinde temiz veriyle oku.