Kimlik Doğrulama

API Anahtarları

HeptaCert API'si Bearer token kimlik doğrulaması kullanır. Her istekte HTTP başlığına anahtarınızı ekleyin:

Authorization: Bearer hc_live_YOUR_KEY

Prefix	Açıklama
`hc_live_`	Canlı anahtar — gerçek veriye erişir

Admin panelinde Ayarlar → API Anahtarları sayfasından oluşturulur. Oluşturma sırasında:

💡

Anahtar yalnızca oluşturulurken bir kez tam olarak gösterilir. Kaydetmeyi unutmayın.

Scope'suz anahtar tüm kaynaklara erişir. Scope atanmış anahtarlar yalnızca ilgili işlemleri yapabilir.

Scope	Açıklama
`events:read`	Etkinlikleri listele ve görüntüle
`events:write`	Etkinlik oluştur, güncelle, sil
`attendees:read`	Katılımcıları listele
`attendees:write`	Katılımcı ekle, güncelle, sil
`certificates:read`	Sertifikaları listele
`certificates:write`	Sertifika yayımla, iptal et
`analytics:read`	Analitik ve raporlara eriş
`sessions:read`	Oturumları listele
`sessions:write`	Oturum oluştur, güncelle, sil
`checkin:write`	Manuel check-in yap
`automations:read`	Otomasyon kurallarını görüntüle
`automations:write`	Otomasyon kuralı oluştur

Entegrasyonunuz için yalnızca gereken scope'ları ekleyin. Örneğin yalnızca raporlama yapan bir araç analytics:read ile yeterlidir.

Sınır aşılınca 429 Too Many Requests döner. Retry-After başlığı kaç saniye beklenileceğini gösterir.

HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1718100012

Güvenlik ihlali şüphesi durumunda anahtarı hemen iptal edin:

İptal edilen anahtarlar derhal geçersiz olur.