Kimlik Doğrulama

Tüm API istekleri kimlik doğrulama için bir Bearer token (API anahtarı) gerektirir.

API Anahtarı Oluşturma

app.ironflock.com adresinden IronFlock’a giriş yapın.
Kullanıcı Ayarları’na gidin.
API Anahtarları bölümüne gidin.
API Anahtarı Oluştur’a tıklayın.
Oluşturulan anahtarı kopyalayın — yalnızca bir kez gösterilir.

API Anahtarını Kullanma

Anahtarı her isteyin Authorization başlığına ekleyin:


curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://api.ironflock.com/v1/ironflock/devices

Python Örneği


import requests
 
API_KEY = "your-api-key"
BASE_URL = "https://api.ironflock.com/v1/ironflock"
 
headers = {"Authorization": f"Bearer {API_KEY}"}
 
response = requests.get(f"{BASE_URL}/devices", headers=headers)
devices = response.json()

JavaScript Örneği


const API_KEY = "your-api-key";
const BASE_URL = "https://api.ironflock.com/v1/ironflock";
 
const response = await fetch(`${BASE_URL}/devices`, {
    headers: { Authorization: `Bearer ${API_KEY}` }
});
const devices = await response.json();

Hata Yanıtları

Durum Kodu	Anlamı
`401`	Eksik veya geçersiz API anahtarı
`403`	Bu işlem için yetersiz ayrıcalıklar
`404`	Kaynak bulunamadı
`422`	Doğrulama hatası (istek parametrelerini kontrol edin)
`500`	İç sunucu hatası

Tüm hata yanıtları bir JSON nesnesi döndürür:


{
    "error": "Hatanın açıklaması"
}