| Firma Adı | Customer ID | VKN | Lisans Kodu | Bitiş Tarihi | Durum | İşlemler |
|---|
| Customer ID / VKN | Lisans Kodu | Son Kontrol | Kontrol Tipi | Aylık İstekler |
|---|
API Kullanım Rehberi
Aşağıda tüm API endpoint'lerinin kullanım bilgileri, gerekli header'lar ve örnek istek/yanıt yapıları yer almaktadır.
Kimlik Doğrulama
Tüm istemci endpoint'leri için aşağıdaki header gereklidir:
LICENCE-API-KEY: <API_KEY>
Bu API key olmadan istek atıldığında 401 Unauthorized hatası alınır.
Lisans Kontrolü (Mevcut İstemciler)
GET
/api/license/check?customerId=GUID&licenseCode=ÜRÜN_KODU
CustomerId ve LicenseCode ile lisans geçerliliğini kontrol eder.
// Yanıt:
{
"isValid": true,
"resultType": 4, // 0=Fail, 1=LicenseExpired, 4=Success
"message": "Lisans geçerlidir.",
"expireDate": "2026-12-31T23:59:59Z"
}
VKN ile Lisans Kontrolü (Yeni)
GET
/api/license/check-by-vkn?vkn=VKN_NUMARASI&licenseCode=ÜRÜN_KODU
VKN (Vergi Kimlik Numarası) ve LicenseCode ile lisans geçerliliğini kontrol eder. Aynı response formatını döner.
// Örnek: GET /api/license/check-by-vkn?vkn=1234567890&licenseCode=EDoc Header: LICENCE-API-KEY: <API_KEY>
Versiyon Kontrolü (Mevcut)
GET
/api/license/check-version?customerId=GUID&licenseCode=ÜRÜN_KODU&customerVersion=1.0
CustomerId ile lisans ve versiyon kontrolü yapar. Lisans geçersizse LicenseExpired döner.
// Yanıt:
{
"resultType": 4, // 1=LicenseExpired, 2=VersionDifferent, 3=VersionRequired, 4=Success
"expireDate": "2026-12-31T23:59:59Z",
"message": ""
}
Versiyon Kontrolü V2 (Yeni - CustomerId Gerektirmez)
GET
/api/license/check-version-v2?licenseCode=ÜRÜN_KODU&customerVersion=1.0
Sadece ürün versiyonunu kontrol eder, CustomerId gerektirmez. Lisans kontrolü yapmaz. Yeni istemciler için önerilen endpoint.
// Örnek: GET /api/license/check-version-v2?licenseCode=EDoc&customerVersion=1.5 Header: LICENCE-API-KEY: <API_KEY>
Lisans Ekleme / Güncelleme
POST
/api/license/add
Yeni lisans ekler veya mevcut lisansı günceller. Password alanı zorunludur.
// İstek:
{
"licenseCode": "EDoc",
"customerId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"customerName": "ABC Şirket",
"licenseExpireTime": "2027-12-31T23:59:59Z",
"password": "ŞİFRE",
"vkn": "1234567890" // Opsiyonel
}
Header: LICENCE-API-KEY: <API_KEY>
Ürün Versiyonu Ekleme
POST
/api/license/version/add
Ürüne yeni versiyon ekler veya mevcut versiyonu günceller.
// İstek:
{
"productCode": "EDoc",
"productName": "E-Fatura Sistemi",
"version": "2.0",
"necessity": 1, // 1=Warning (Uyarı), 2=Must (Zorunlu)
"versionLog": "Yeni özellikler eklendi",
"password": "ŞİFRE"
}
Header: LICENCE-API-KEY: <API_KEY>
ResultType Değerleri
| Değer | Sabit | Açıklama |
|---|---|---|
| 0 | Fail | Lisans bulunamadı / Genel hata |
| 1 | LicenseExpired | Lisans süresi dolmuş |
| 2 | VersionDifferent | Yeni versiyon mevcut (uyarı) |
| 3 | VersionRequired | Zorunlu güncelleme gerekli |
| 4 | Success | Her şey yolunda |