API Referansı

SetGet; çalışma alanlarına, projelere, iş öğelerine, faturalandırmaya ve daha fazlasına programatik erişim için bir REST API sunar.

Taban URL

Tüm API uç noktaları SetGet instance URL'nize göredir:

https://app.setget.ai/api/

Self-hosted kurulumlarda kendi instance domain adresinizle değiştirin.

Çoğu uç nokta, oturum çerezi (session cookie) ile kimlik doğrulama gerektirir. Oturum almak için giriş yapın:

bash

POST /auth/sign-in/
Content-Type: application/json

{
  "email": "user@example.com",
  "password": "your-password",
  "medium": "email"
}

Yanıt, bir setget_session çerezi ayarlar. Sonraki isteklerde bu çerezi gönderin:

bash

Cookie: setget_session=<token>

Admin uç noktaları (/api/admin/*) instance admin kimlik doğrulaması gerektirir:

bash

POST /api/instances/admins/sign-in/

Başarılı yanıtlar JSON döner:

json

{
  "id": "abc123",
  "name": "Example",
  "created_at": "2026-04-08T12:00:00Z"
}

Liste uç noktaları sayfalanmış sonuçlar döner:

json

{
  "results": [...],
  "total": 42
}

Hata yanıtları:

json

{
  "error": "description of the error"
}

Kod	Anlamı
200	Başarılı
201	Oluşturuldu
204	İçerik Yok (başarılı silme)
400	Hatalı İstek
401	Kimlik Doğrulanmadı
402	Ödeme Gerekli (faturalandırma limiti)
403	Yasak
404	Bulunamadı
409	Çakışma (yinelenen)
503	Servis Kullanılamıyor