Developer Portal
HeptaCert REST API ile etkinlik, sertifika ve CRM verilerinizi programatik olarak yönetin. Tüm endpoint'ler JSON döndürür ve Bearer token kimlik doğrulaması gerektirir.
Kimlik Doğrulama
Her istekte Authorization header'ı gönderin:
curl https://cert.heptapusgroup.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 |
Rate 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://cert.heptapusgroup.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",
"attendee_email": "ahmet@example.com",
"issued_at": "2026-06-01T10:00:00Z",
"cert_url": "https://cert.heptapusgroup.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? contact@heptapusgroup.com adresine yazın.