Geliştiriciler · API v1

API entegrasyonu üç adımda.

API kullanan uygulamalar için Robrun karar API'si isteği değerlendirir. Form, giriş ve bot koruması için API geliştirmeden kurulum seçenekleri de yol haritamızda. Pilot erişim henüz herkese açık değil.

1. Karar isteği gönderin

API anahtarını yalnızca sunucuda saklayın. İşlem türü ve doğrulanmış istemci IP adresini gönderin.

İstemci tarafındaki JavaScript'e API anahtarı koymayın.
HTTP request · Example
POST /api/v1/security/check
Authorization: Bearer <API_KEY>
Content-Type: application/json

{
  "operation": "login",
  "client_ip": "203.0.113.10"
}

2. Güvenlik kararını işleyin

HTTP 200 cevabında allowed alanını denetleyin. false bir engellemedir; HTTP 503 ve timeout otomatik izin değildir.

HTTP response · Example
{
  "decision": "block",
  "allowed": false,
  "reason": "rate_limit_exceeded",
  "rate_limit": {
    "limit": 5,
    "remaining": 0,
    "reset_after_seconds": 42
  },
  "request_id": "..."
}
3. Adım · Uygulamada kararın uygulanması

Sonucu değerlendirin, güvenli davranışı koruyun.

Uygulamanız allowed=false kararını engelleme olarak uygulamalıdır. Servis geçici erişilemezse entegrasyonunuzun güvenli davranışı önceden belirlenmelidir. Üretim erişimi ve müşteri anahtarı dağıtımı henüz başlamadı.

API referansı

RouteMethodResult
/api/v1/security/checkPOST200 + allowed true/false; 400, 401, 405, 413, 415, 503

HTTP durum kodlarının anlamı

HTTPAnlamıEntegrasyon davranışı
200Geçerli güvenlik kararıallowed true/false alanını okuyun
400Geçersiz JSON veya işlemİsteği düzeltin
401Eksik/geçersiz Bearer anahtarıAnahtarı sunucu tarafında kontrol edin
405Desteklenmeyen HTTP metoduPOST kullanın
413İstek boyut limiti aşıldıGövdeyi küçültün
415Desteklenmeyen içerik türüapplication/json gönderin
503Karar hizmeti kullanılamıyorOtomatik izin vermeyin; güvenli fallback uygulayın

Gelecek entegrasyonlar (henüz aktif değil)

CAPTCHA doğrulama, form bileşenleri, hazır eklentiler, giriş savunması ve güvenlik olayları için yeni sözleşmeler roadmap kapsamındadır. Henüz kullanılabilir endpoint ilan edilmiyor.

Örnekler dokümantasyon amaçlıdır. Ürün özelliklerinin tamamı için Feature Set sayfasına bakın.