Hızlı başlangıç

Bu sayfanın sonunda çalışan bir karar akışınız olacak: bir veri modeli, bir senaryo, bir kural ve gerekçesiyle dönen bir karar.

API anahtarı oluşturun

Yönetim arayüzünde Settings → API Keys altından yeni bir anahtar üretin. Anahtar yalnızca bir kez gösterilir; kaybederseniz yenisini üretmeniz gerekir.Tüm istekler bu anahtarı X-API-KEY başlığında taşır.

Veri modelinizi tanımlayın

Your Data altında bir tablo oluşturup alanlarını ekleyin. Alan adları sizin seçtiğiniz adlardır; Krino hazır bir şema dayatmaz.İki alan her tabloda zorunludur: kaydı tekilleştiren object_id ve sürümü belirleyen updated_at.Ayrıntı: Veri modeli.

Bir olay gönderin

curl -X POST https://api.krino.uk/api/ingestion/sanal_pos \
  -H "X-API-KEY: $KRINO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "object_id": "tx-88214",
    "updated_at": "2026-08-06 10:00:00",
    "musteri_no": "M10471",
    "sepet_tutari": 12500.00,
    "client_ip": "203.0.113.45"
  }'

Yanıt 202 ise kayıt kabul edilmiş ve yazılmak üzere kuyruğa alınmıştır. Doğrulama yanıt dönmeden önce yapılır: bilinmeyen tablo, eksik object_id ya da tipi tutmayan bir alan 400 ile ve açıklamasıyla reddedilir.

Bir senaryo ve kural kurun

Scenarios → New scenario ile tabloyu seçin, ardından sürümün kurallarını ekleyin. Her kural bir koşul ağacı ve bir puandır. Eşikleri de burada belirlersiniz: inceleme, engelle-ve-incele ve red.Ayrıntı: Senaryolar ve kurallar.

Karar isteyin

curl -X POST https://api.krino.uk/api/decisions \
  -H "X-API-KEY: $KRINO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "scenario_id": "019fd100-0000-7000-9000-000000000001",
    "object_type": "sanal_pos",
    "with_rule_execution_details": true,
    "trigger_object": {
      "object_id": "tx-88214",
      "updated_at": "2026-08-06 10:00:00",
      "musteri_no": "M10471",
      "sepet_tutari": 12500.00,
      "client_ip": "203.0.113.45"
    }
  }'

Dönen yanıt

{
  "decision": {
    "outcome": "BlockAndReview",
    "score": 92,
    "scenario_name": "E-ticaret ödeme riski",
    "scenario_version": 3
  },
  "rule_executions": [
    { "rule_name": "Geçici e-posta sağlayıcı", "outcome": "hit", "score": 40 },
    { "rule_name": "Datacenter / VPN çıkışı", "outcome": "hit", "score": 30 },
    { "rule_name": "Sepet tutarı olağan dışı", "outcome": "hit", "score": 25 },
    { "rule_name": "Yaptırım listesi eşleşmesi", "outcome": "no_hit", "score": 0 }
  ],
  "execution_time_ms": 34
}

with_rule_execution_details alanını false bırakırsanız yalnızca sonuç ve puan döner. Gerekçeyi kaydetmiyorsanız bile açık bırakmanızı öneririz — bir itiraz geldiğinde geriye dönük üretilemez.

Sonraki adım

Kuralınızı canlıya almadan önce test edin — hem örnek veriyle, hem gerçek trafiğin üstünde gölge koşumla.

Başlangıç

Platform

Kararlar

Veri ve olaylar

Sinyaller ve tarama

Kendi sunucunuzda

Hızlı başlangıç

Dönen yanıt

Sonraki adım

​Dönen yanıt

​Sonraki adım

Dönen yanıt

Sonraki adım