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.
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.
{
"decision": "block",
"allowed": false,
"reason": "rate_limit_exceeded",
"rate_limit": {
"limit": 5,
"remaining": 0,
"reset_after_seconds": 42
},
"request_id": "..."
}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ı
| Route | Method | Result |
|---|---|---|
/api/v1/security/check | POST | 200 + allowed true/false; 400, 401, 405, 413, 415, 503 |
HTTP durum kodlarının anlamı
| HTTP | Anlamı | Entegrasyon davranışı |
|---|---|---|
| 200 | Geçerli güvenlik kararı | allowed true/false alanını okuyun |
| 400 | Geçersiz JSON veya işlem | İsteği düzeltin |
| 401 | Eksik/geçersiz Bearer anahtarı | Anahtarı sunucu tarafında kontrol edin |
| 405 | Desteklenmeyen HTTP metodu | POST kullanın |
| 413 | İstek boyut limiti aşıldı | Gövdeyi küçültün |
| 415 | Desteklenmeyen içerik türü | application/json gönderin |
| 503 | Karar hizmeti kullanılamıyor | Otomatik 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.