Geliştirici 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.
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 |
|---|
API erişimi içeren planlarda dakika kotası organizasyon genelinde tüm anahtarlar arasında paylaşılır. Geçerli limitler aşağıdaki plan kataloğundan alınır; kurumsal limitler sözleşmede belirlenir. Saatlik sabit bir kota uygulanmaz.
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 Bas | 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 |
Program kataloğu (herkese açık)
| GET | /api/public/marketplace | Listelenmiş programları getir | Herkese açık |
| GET | /api/public/marketplace/{id} | Program detayı | Herkese açık |
İletişim formları (herkese açık)
| GET | /api/public/forms/{slug}/meta | Form tanımını getir | Herkese açık |
| POST | /api/public/forms/{slug}/submit | Form gönderimi | Herkese açık |
Ö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/verify/550e8400-e29b-41d4-a716-446655440000"
}
]Sıkça 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.