Geliştirici Kaynakları

ALPAR Genel API

ALPAR'ın AI olaylarının kamu arşivine salt okunur, kimlik doğrulamasız erişim. Gazeteciler, araştırmacılar ve akademisyenler için.

Kimlik doğrulama gerekmez

Okuma uç noktaları herkese açık. Alıntı dostu.

Edge önbellekli

60s tarayıcı, 5dk CDN. Stale-while-revalidate.

OpenAPI 3.0 spesifikasyonu

Herhangi bir dilde istemci oluşturun.

Uç Noktalar

Tüm yanıtlar JSON. Hatalar standart hata formatını izler.

GET/api/v1/incidents

Yayınlanmış AI olaylarının sayfalanmış listesini döndürür. İsteğe bağlı sorgu parametreleri: limit (1-100, varsayılan 20), category, severity, provider (serbest metin model adı).

curl https://alparai.com/api/v1/incidents?limit=5&severity=critical

# Response
{
  "data": [
    {
      "id": "0a2c6a31-...",
      "title": "Teen Suicide Linked to AI Chatbot (Character.AI)",
      "description": "...",
      "severity": "critical",
      "category": "manipulation",
      "is_anonymous": true,
      "incident_date": "2024-02-28T00:00:00Z",
      "views": 1234,
      "upvotes": 56,
      "model": "Character.AI",
      "created_at": "2026-06-09T..."
    }
  ],
  "meta": { "count": 1, "limit": 5, "generated_at": "..." }
}

GET/api/v1/incidents/{id}

UUID ile tek bir yayınlanmış olayı döndürür. Bulunamazsa veya henüz yayınlanmamışsa 404.

curl https://alparai.com/api/v1/incidents/0a2c6a31-e4d7-45d5-9b94-7ab0e6eeb041

# Response
{
  "data": {
    "id": "0a2c6a31-...",
    "title": "...",
    ...
  }
}

GET/api/v1/providers

Takip edilen AI sağlayıcılarının, bağlantılarının, doğrulama durumlarının ve güncel Güven Puanlarının listesini döndürür.

curl https://alparai.com/api/v1/providers

# Response
{
  "data": [
    {
      "id": "9a12cf42-...",
      "name": "OpenAI",
      "slug": "openai",
      "website_url": "https://openai.com",
      "logo_url": "...",
      "is_verified": true,
      "trust_score": 88
    }
  ],
  "meta": { "count": 1, "generated_at": "..." }
}

GET/api/v1/stats

Toplam olay sayısı, sağlayıcı sayısı, kategorilere göre dağılım ve ortalama ekosistem güven puanı dahil olmak üzere toplu platform istatistiklerini döndürür.

curl https://alparai.com/api/v1/stats

# Response
{
  "data": {
    "total_incidents": 142,
    "total_providers": 8,
    "average_trust_score": 76.4,
    "by_category": {
      "hallucination": 64,
      "privacy": 32,
      "bias": 46
    }
  },
  "meta": { "generated_at": "..." }
}

OpenAPI 3.0 spesifikasyonu

Tercih ettiğiniz dilde tipli istemciler oluşturmak için tam OpenAPI spesifikasyonunu indirin.

/openapi.yaml

Hız limitleri

IP başına dakikada 100 istek. Patlama izin verilir. Aşıldığında retryAfter ile 429 döndürür.