Hızlı Başlangıç Kılavuzu

Bu kılavuz, RavenON Yangın Güvenlik AI sistemini kullanmaya başlamanız için gereken temel adımları içerir.

Ön Gereksinimler

Başlamadan önce aşağıdakilere sahip olduğunuzdan emin olun:

• Aktif bir RavenON hesabı
• API anahtarı
• Temel programlama bilgisi (Python, JavaScript, veya cURL)

Adım 1: API Anahtarı Alma

API anahtarınızı almak için:

1. RavenON Portal'a giriş yapın
2. "API Anahtarları" bölümüne gidin
3. "Yeni Anahtar Oluştur" butonuna tıklayın
4. Anahtarınızı güvenli bir yerde saklayın

Adım 2: İlk API Çağrısı

Python ile

import requests

API_KEY = "your_api_key_here"
BASE_URL = "https://api.ravenon.com/v1"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

# Sistem durumunu kontrol et
response = requests.get(f"{BASE_URL}/status", headers=headers)
print(response.json())

JavaScript ile

const API_KEY = 'your_api_key_here';
const BASE_URL = 'https://api.ravenon.com/v1';

async function checkStatus() {
  const response = await fetch(`${BASE_URL}/status`, {
    headers: {
      'Authorization': `Bearer ${API_KEY}`,
      'Content-Type': 'application/json'
    }
  });
  
  const data = await response.json();
  console.log(data);
}

checkStatus();

cURL ile

curl -X GET https://api.ravenon.com/v1/status \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Adım 3: Görüntü Analizi

Yangın tespiti için görüntü analizi yapmak:

import requests
import base64

def analyze_image(image_path):
    # Görüntüyü base64'e çevir
    with open(image_path, 'rb') as image_file:
        image_data = base64.b64encode(image_file.read()).decode()
    
    # API'ye gönder
    response = requests.post(
        f"{BASE_URL}/analyze",
        headers=headers,
        json={
            "image": image_data,
            "detection_type": "fire",
            "confidence_threshold": 0.8
        }
    )
    
    return response.json()

# Kullanım
result = analyze_image("path/to/image.jpg")
print(f"Yangın tespit edildi: {result['fire_detected']}")
print(f"Güven skoru: {result['confidence']}")

Adım 4: Webhook Kurulumu

Gerçek zamanlı bildirimler almak için webhook kurun:

// Express.js örneği
const express = require('express');
const app = express();

app.post('/webhook/fire-alert', express.json(), (req, res) => {
  const { event_type, data, timestamp } = req.body;
  
  if (event_type === 'fire_detected') {
    console.log('YANGIN ALARMI!');
    console.log('Konum:', data.location);
    console.log('Güven:', data.confidence);
    
    // Acil müdahale prosedürlerini başlat
    triggerEmergencyResponse(data);
  }
  
  res.status(200).send('OK');
});

app.listen(3000, () => {
  console.log('Webhook sunucusu çalışıyor');
});

Adım 5: Gerçek Zamanlı İzleme

Kamera akışından gerçek zamanlı analiz:

import cv2
import requests
import time

def monitor_camera(camera_id):
    cap = cv2.VideoCapture(camera_id)
    
    while True:
        ret, frame = cap.read()
        if not ret:
            break
        
        # Her 5 saniyede bir analiz yap
        if int(time.time()) % 5 == 0:
            # Frame'i encode et
            _, buffer = cv2.imencode('.jpg', frame)
            image_data = base64.b64encode(buffer).decode()
            
            # Analiz et
            result = analyze_image_data(image_data)
            
            if result['fire_detected']:
                print("⚠️ YANGIN TESPİT EDİLDİ!")
                # Alarm tetikle
                trigger_alarm()
        
        # Görüntüyü göster
        cv2.imshow('RavenON Fire Detection', frame)
        
        if cv2.waitKey(1) & 0xFF == ord('q'):
            break
    
    cap.release()
    cv2.destroyAllWindows()

# Kullanım
monitor_camera(0)  # 0 = varsayılan kamera

Hata Yönetimi

API çağrılarında hata yönetimi:

try:
    response = requests.post(f"{BASE_URL}/analyze", 
                           headers=headers, 
                           json=payload)
    response.raise_for_status()
    result = response.json()
except requests.exceptions.HTTPError as e:
    if e.response.status_code == 401:
        print("Kimlik doğrulama hatası: API anahtarınızı kontrol edin")
    elif e.response.status_code == 429:
        print("Rate limit aşıldı: Lütfen bekleyin")
    else:
        print(f"HTTP Hatası: {e}")
except requests.exceptions.RequestException as e:
    print(f"Bağlantı hatası: {e}")

Rate Limiting

API kullanım limitleri:

| Plan | İstek/Dakika | İstek/Gün | |------|--------------|-----------| | Free | 10 | 1,000 | | Basic | 60 | 10,000 | | Pro | 300 | 100,000 | | Enterprise | Sınırsız | Sınırsız |

Sonraki Adımlar

• API Referansı - Tüm endpoint'leri keşfedin
• En İyi Uygulamalar - Optimizasyon ipuçları
• Örnek Projeler - Hazır kod örnekleri

Destek

Yardıma mı ihtiyacınız var?

• 📧 E-posta: support@ravenon.com
• 📞 Telefon: +90 216 912 23 41
• 💬 Canlı destek: portal.ravenon.com/support