Skip to content

Public Endpoint'ler

/api/v1/public/* ailesi kasıtlı "harici entegrasyonlar" yüzeyidir. Buradaki endpoint'ler Authorization: Bearer ... üzerinden bir API token kabul eder ve scope'ları doğrular; pano oturum cookie'sini kabul etmezler.

OpenAPI

GET /api/v1/public/openapi.json     tam spec, auth gerekmez

Spec, mevcut endpoint'ler ve parametre şekilleri için otoriter kaynaktır.

Yaygın endpoint'ler

GET  /api/v1/public/posts            listele  — scope: posts:read
POST /api/v1/public/posts            oluştur — scope: posts:write
GET  /api/v1/public/accounts         listele  — scope: accounts:read

Kimlik doğrulama hata modları

  • 401 invalid_token — token decode edilmiyor veya saklanan bir hash ile eşleşmiyor.
  • 401 token_revoked — token kayıdında revoked_at ayarlanmış.
  • 403 missing_scope — token gerekli scope'u taşımıyor.

Public olmayan

Cookie-only yüzey (çalışma alanları, faturalandırma, yönetim, pazaryeri, takım yönetimi) bugün kasıtlı olarak hiçbir public-API yansımasına sahip değildir. Cookie-auth yüzeyine karşı yalnızca tarayıcı oturumunu kontrol ettiğin zaman geliştir.

İlgili