Geliştirici API'si.

Hızlı başlangıç

# 1. Personal access token üret
# Settings → API → Token oluştur

curl -X GET https://api.zelthio.com/v1/tasks \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json"

Authentication

• OAuth 2.0 (PKCE) — kullanıcı uygulamaları için önerilir. Keycloak üzerinden authorize edilir.
• Personal Access Token — bireysel script'ler için. Settings → API.
• Service Account — sunucu-sunucu entegrasyonu için. Domain admini tarafından oluşturulur.

Endpoint'ler

Webhook'lar

Zelthio, ekibindeki olayları (görev oluşturuldu, AI yanıt verdi, dosya yüklendi vs.) belirttiğin endpoint'e POST eder. HMAC-SHA256 ile imzalanır:

POST https://your-server.com/zelthio-hook
X-Zelthio-Signature: sha256=abcd...
X-Zelthio-Event: task.created

{
  "event": "task.created",
  "timestamp": "2026-05-09T10:00:00Z",
  "data": {
    "id": "tsk_abc123",
    "title": "Login akışı düzelt",
    "status": "todo"
  }
}

Rate limiting

• OAuth/PAT: 1.000 req/dk per user
• Service Account: 10.000 req/dk per org
• AI chat endpoint: 60 req/dk per user (model cost'u nedeniyle ayrı)

Limit aşıldığında 429 Too Many Requests +Retry-After header döner.

SDK'lar

Resmi istemci paketleri yol haritasında. Şimdilik REST çağrılarını fetch / curl veya kendi HTTP istemcinle yap; OpenAPI şemasından tip veya client üretebilirsin.

• JavaScript / TypeScript — önerilen: OpenAPI Generator ile şema importu.
• Python / Go — aynı şema üzerinden üretim veya ince HTTP sarmalayıcı.
• Hazır @zelthio/sdk paketi duyurulduğunda bu sayfa ve dokümantasyon güncellenecek.

OpenAPI şeması

Tüm endpoint'lerin detaylı OpenAPI 3.1 şeması: /openapi.json — Postman, Insomnia veya Swagger UI'a doğrudan import edebilirsin.