Developer Portal

REST API ile etkinlik, sertifika ve CRM verilerinizi sisteminize entegre edin. Tüm endpoint'ler JSON döndürür, Bearer token kimlik doğrulama gerektirir.

API Anahtarı Al

Kimlik Doğrulama

Her istekte Authorization header'ı gönderin:

curl https://heptacert.com/api/admin/events \
  -H "Authorization: Bearer hc_YOUR_API_KEY"

Rate Limit

Plan	İstek / Dakika	İstek / Saat
Starter	60	3.600
Growth	300	18.000
Enterprise	1000	60.000

Limit aşıldığında 429 Too Many Requests döner. Retry-After header'ı bekleme süresini belirtir.

Endpoint'ler

Etkinlikler

GET	/api/admin/events	Tüm etkinlikleri listele	events:read
POST	/api/admin/events	Yeni etkinlik oluştur	events:write
GET	/api/admin/events/{id}	Etkinlik detayı	events:read
PATCH	/api/admin/events/{id}	Etkinlik güncelle	events:write
DELETE	/api/admin/events/{id}	Etkinliği sil	events:write

Sertifikalar

GET	/api/admin/events/{id}/certificates	Sertifikaları listele	certificates:read
POST	/api/admin/events/{id}/certificates	Sertifika oluştur	certificates:write
GET	/api/admin/certificates/{cert_id}	Sertifika detayı	certificates:read
DELETE	/api/admin/certificates/{cert_id}	Sertifika iptal et	certificates:write

Katılımcılar

GET	/api/admin/events/{id}/attendees	Katılımcıları listele	attendees:read
POST	/api/admin/events/{id}/attendees	Katılımcı ekle	attendees:write
PATCH	/api/admin/events/{id}/attendees/{aid}	Katılımcı güncelle	attendees:write

CRM

GET	/api/admin/crm/accounts	Şirketleri listele	crm:read
POST	/api/admin/crm/accounts	Yeni şirket oluştur	crm:write
GET	/api/admin/crm/pipeline	Pipeline görünümü	crm:read

Analitik

GET	/api/admin/analytics/org/overview	Genel bakış metrikleri	analytics:read
GET	/api/admin/analytics/org/crm	CRM analitik verileri	analytics:read
GET	/api/admin/analytics/org/training-compliance	Eğitim uyum raporu	analytics:read

Marketplace (Public)

GET	/api/public/marketplace	Listelenmiş programları getir	Public
GET	/api/public/marketplace/{id}	Program detayı	Public

Lead Forms (Public)

GET	/api/public/forms/{slug}/meta	Form tanımını getir	Public
POST	/api/public/forms/{slug}/submit	Form gönderimi	Public

Örnek: Sertifika Listele

curl "https://heptacert.com/api/admin/events/123/certificates?limit=50" \
  -H "Authorization: Bearer hc_YOUR_API_KEY"

# Yanıt:
[
  {
    "id": 9001,
    "public_id": "abc123",
    "attendee_name": "Ahmet Yılmaz",
    "issued_at": "2026-06-01T10:00:00Z",
    "cert_url": "https://heptacert.com/c/abc123"
  }
]

Sık Sorulan Sorular

HeptaCert API'si nasıl çalışır?

HeptaCert REST API, Bearer token kimlik doğrulaması kullanır. Tüm istekler JSON döndürür. API anahtarını /admin/settings/api adresinden oluşturabilirsiniz.

Hangi programlama dilleri destekleniyor?

REST API olduğu için Python, JavaScript/Node.js, PHP, Go, Ruby gibi HTTP isteği yapabilen her dille kullanılabilir.

Sertifika doğrulama API'si var mı?

Evet. GET /api/v/certs/{cert_code} endpoint'i sertifika geçerliliğini kontrol eder. Bu endpoint public'tir ve kimlik doğrulama gerektirmez.

Webhook desteği var mı?

Evet. Sertifika oluşturulması, katılımcı eklenmesi gibi olaylar için webhook endpoint'leri tanımlayabilirsiniz.

Sorunuz mu var? destek@heptacert.com adresine yazın.