API Dokümantasyonu

RiskYZ vaka kütüphanesine programatik, salt-okunur erişim. Kimlik doğrulama gerekmez; veriler CC BY-SA 4.0 lisansıyla sunulur.

Genel Bakış

API, yalnızca onaylanmış ve yayınlanmış vakaları sunar; inceleme sürecindeki bildirimler ve editör verileri erişime kapalıdır. Tüm yanıtlar UTF-8 kodlamalı JSON'dır ve CORS açıktır; tarayıcı üzerinden de doğrudan çağrılabilir.

Taban Adres
https://www.riskyz.org/api/v1

Vaka Listesi

GET/api/v1/cases

Onaylanmış vakaları yayın tarihine göre (en yeni önce) listeler.

Sorgu Parametreleri
category

Risk alanı koduna göre filtreler (1–7). Kodların anlamı için taksonomiye bakınız. İsteğe bağlı.

limit

Döndürülecek en fazla vaka sayısı (1–100). Varsayılan: 100. İsteğe bağlı.

Örnek İstek
curl "https://www.riskyz.org/api/v1/cases?category=2&limit=10"
Örnek Yanıt
{
  "count": 128,
  "license": "CC BY-SA 4.0",
  "cases": [
    {
      "id": "RISKYZ-2026-00891",
      "title": "...",
      "summary": "...",
      "description": "...",
      "category": "2",
      "subcategory": "2.1",
      "entity": "ai",
      "intent": "unintentional",
      "timing": "post_deployment",
      "sectors": ["finance"],
      "geography": [],
      "isGlobal": false,
      "locations": [{ "countryCode": "TR", "provinceCode": "34" }],
      "affectedSystem": "...",
      "developer": null,
      "incidentDate": "2026-03-14",
      "publishedDate": "2026-04-02",
      "updatedDate": "2026-04-10",
      "sources": [{ "label": "...", "url": "https://...", "type": "article" }],
      "relatedCases": ["RISKYZ-2026-00742"],
      "tags": ["..."],
      "origins": ["mit", "aiid"],
      "aiidIncidentId": 389,
      "classificationSource": "mit"
    }
  ]
}

Tek Vaka

GET/api/v1/cases/{riskyz_id}

Kalıcı RISKYZ kimliğiyle tek bir vakayı döndürür. Liste yanıtındaki alanlara ek olarak relatedCases alanında ilişkili vakaların kimlikleri yer alır. Vaka bulunamazsa 404 döner.

Örnek İstek
curl "https://www.riskyz.org/api/v1/cases/RISKYZ-2026-00162"

Alan Sözlüğü

id

Kalıcı RISKYZ kimliği (örn. RISKYZ-2026-00162). Atıflarda bu kimlik kullanılır.

category / subcategory

Risk alanı ve alt alan kodları. Taksonomi metodoloji sayfasında tanımlıdır.

entity / intent / timing

Sınıflandırma eksenleri: riskin kaynağı, niyet ve yaşam döngüsündeki zamanlaması.

locations

Vaka konumları. countryCode ISO 3166-1 alpha-2; provinceCode yalnızca Türkiye için il plaka kodu.

incidentDate / publishedDate

Olay tarihi ve RiskYZ'de yayınlanma tarihi (YYYY-AA-GG).

sources

Vakanın dayandığı doğrulanmış kaynaklar (url, label, type, varsa doi).

sectors

Sektör anahtarları. İNGİLİZCE değerler döner: healthcare, finance, education, legal, defense, transportation, public_services, social_media, media, technology, retail, culture, other. Liste zamanla genişleyebilir; bilinmeyen bir değerle karşılaşabileceğinizi varsayın.

aiidIncidentId

Vakanın türetildiği AI Incident Database olay numarası; kaynağı yoksa null. Kataloğun %99'u AIID kayıtlarından türetilmiştir ve bu alan iki kimlik arasında makine tarafından okunabilir eşleşmeyi verir: incidentdatabase.ai/cite/{aiidIncidentId}. RISKYZ kimliği AIID kimliğinin yerine geçmez, ona eklenir.

classificationSource

Risk etiketini kimin verdiği: mit (MIT AI Risk Repository etiketi birebir taşındı), editor (editör verdi ya da doğruladı), ai (öneri sistemi verdi, henüz gözden geçirilmedi, geçicidir). Atıf yaparken etiketin dayanağını bu alandan görebilirsiniz.

origins

Vakanın kökeni: mit ve/veya aiid. Kaynak kataloglara izlenebilirlik sağlar.

isGlobal / geography

isGlobal, tek bir ülkeye bağlanamayan kapsamı belirtir. geography serbest metin konum bilgisidir; yapılandırılmış konum için locations kullanın.

updatedDate

Kaydın son güncellenme zamanı. Görüntülenme sayacı da bu alanı güncellediği için içerik değişikliği göstergesi DEĞİLDİR.

description

Olayın tam açıklaması. Liste yanıtında da döner.

relatedCases

İlişkili vakaların RISKYZ kimlikleri (tek vaka uç noktasında).

Kullanım Koşulları ve Atıf

Veriler Creative Commons BY-SA 4.0 lisansı altındadır: kaynak göstererek serbestçe kullanabilir, paylaşabilir ve işleyebilirsiniz. ShareAlike koşulu gereği türev çalışmalar da aynı lisansla paylaşılmalıdır. Akademik çalışmalarda vakalara RISKYZ kimliğiyle atıf yapınız; her vaka sayfası hazır APA ve BibTeX atıf bilgisi sunar.

API adil kullanım esasıyla sunulur. Kütüphanenin tamamına ihtiyaç duyuyorsanız istekleri aralıklandırmanızı rica ederiz; sorularınız için info@riskyz.org.