primeAPI ile
Uygulamanıza e-imza özelliği kazandırın
Karmaşık ve kullanımı zor SDK'lar ile uğraşmadan, sadece API kullanarak mevcut uygulamalarınızda yasal geçerli e-imza ve mobil imza atılmasını sağlayabilirsiniz.
// kullanıcı AÇ butonuna bastığında e-imza aracı açılır
function OpenSignerApp() {
try {
window.location.href = 'onaylarimsignerapp:"start"';
// e-imza aracına bağlanılmaya çalışılır
TryToConnect();
} catch (err) {
console.log("open signer app error.", err);
}
}
Öne çıkan özellikler
Kullanıcılarınız e-imza atmak için bilgisayarlarına Java kurmak zorunda kalmasın.
Her işletim sisteminde de sorunsuz bir biçimde e-imza atabilir.
CAdES, PAdES ve XAdES standartlarının detaylarını öğrenmeden, sadece API'leri çağırarak uzun dönem doğrulamalı yasal geçerli e-imza atabilirsiniz.
Neden SDK Değil, primeAPI?
SDK tabanlı e-imza entegrasyonları istemci tarafında kurulum ve bakım yükü getirir. primeAPI bu yükleri kaldırarak REST API ile aynı işlevselliği sunar.
| Konu | Klasik SDK | primeAPI |
|---|---|---|
| Java bağımlılığı | Her kullanıcı JRE kurulumu yapar | Java gerekmez |
| Platform desteği | Windows-only veya sınırlı | Windows + macOS + Linux |
| Versiyon yönetimi | SDK'yı yeniden derle, deploy et | API'de otomatik güncelleme |
| Backend dili | Spring / .NET sınırlı | Backend agnostik (REST) |
| Hotfix / patch | SDK yeniden dağıtımı | API endpoint güncellenir, istemci etkilenmez |
Sonuç: mevcut uygulamanıza 3 REST çağrısı ekleyip 1-2 gün içinde canlıya alırsınız.
4 Adımda Entegrasyonu Tamamlayın
Hangi geliştirme ortamını kullandığınız farketmez. REST API ile en kısa sürede e-imza ve mobil imza atabilir hale gelin.
- UI Bileşenlerini Ekleyin
Sağladığımız örnek JavaScript kodlarını ve UI bileşenlerini mevcut web uygulamanıza entegre edin. Windows, macOS ve Linux kullanıcılarınızın tarayıcısından Java kurulumu olmadan imza atabilmesi için hazır arayüz bileşenleri mevcuttur.
- Kendi Ortamınıza 3 API Ekleyin
Sağladığımız örnek webAPI metodlarını servis katmanınıza ekleyin. REST API backend agnostik — .NET, Java, Node.js, Python, Go, PHP ve HTTP istekleri atabilen her ortamda çalışır.
- API Anahtarı Alın
ONAYLARIM primeAPI için test veya canlı ortam anahtarı temin edin. Test anahtarı ücretsizdir; canlıya geçişte sadece header değişir, kod değişikliği gerekmez.
- Belgelerinize E-İmza Atılsın
Sisteminizi kullanan kullanıcılar Windows, macOS veya Linux cihazlarından Java bağımlılığı olmadan gelişmiş e-imza ve mobil imza atabilir. CAdES, PAdES, XAdES profilleri ve LTA/A uzun dönem arşiv imzası desteklenir.
Tüm ihtiyaçlarınız için
Tek bir platform
e-İmza dışında doküman odaklı diğer servislerimizi de kullanarak geliştirme sürenizi kısaltabilirsiniz.
- CAdES e-İmza
- CAdES standartının detaylarını öğrenmek zorunda kalmadan zaman damgalı gelişmiş e-imza atın.
- PAdES e-İmza
- PDF dosyalarına uzun dönem doğrulamalı, görsel imza atın.
- XAdES e-İmza
- XML dosyalarına kolayca zaman damgalı gelişmiş e-imza atın.
- Mobil İmza
- Tüm operatörlerle mobil imza atabilirsiniz.
- PDF Dönüştürme
- Office ve resim dosyalarını PDF'e dönüştürebilirsiniz.
- PDF Üzerinde Değişiklik Yapma
- PDF üzerine e-imzalıdır ve doğrulama kodu bilgisi gibi alanları kolaylıkla ekleyebilirsiniz.
Kurumsal Geliştiricilerin Tercihi
Havayollarından bakanlıklara, otomotiv OEM'lerinden sağlık gruplarına kadar Türkiye'nin önde gelen kurumlarının yazılım ekipleri primeAPI ile e-imza entegrasyonu yapıyor.
primeAPI ekosisteminden örnekler:
Regülasyon ve Teknik Standartlar
Yasal Uyumluluk
- 5070 sayılı Elektronik İmza Kanunu — primeAPI ile atılan imzalar ıslak imza ile yasal olarak eşdeğerdir.
- eIDAS uyumu — Avrupa Birliği elektronik imza tüzüğü.
- KVKK — kurumsal verilere uygun işleme çerçevesi.
- KamuSM rehberi — kamu projelerinde zorunlu P1-P4 profil desteği.
Desteklenen İmza Standartları
- CAdES (ETSI TS 101 733) — dosya imzası, zaman damgalı
- PAdES (ETSI TS 102 778) — PDF imzası, görsel damga destekli
- XAdES (ETSI TS 101 903) — XML imzası
- P1-P4 imza seviyeleri ve LTA/A uzun dönem arşiv
Sertifika Sağlayıcıları (ESHS)
KamuSM, TürkTrust, e-Güven, EBG, e-Tuğra ve BTK onaylı diğer tüm ESHS sağlayıcıları. Kullanıcının sertifikasının hangi sağlayıcıdan olduğunun entegrasyonunuza etkisi yoktur.
Zaman Damgası
TÜBİTAK ve BTK onaylı diğer zaman damgası sağlayıcıları otomatik uygulanır — imza bütünlüğü yıllar sonra da kanıtlanır.
Yönetici / CIO Perspektifi
Teknik tercih ötesinde, primeAPI kurumsal karar kriterleri açısından dört boyutta avantaj sağlar.
Gizli Maliyetler
SDK bakımı, kullanıcı destek talepleri, versiyon dağıtımı, uyumluluk riski — primeAPI ile bu yüklerin hiçbiri kurum içinde değildir.
Entegrasyon Süresi
Geliştirici ekip e-imza kriptografisi öğrenmek yerine 3 REST çağrısı ekleyerek 1-2 günde canlıya alır — aylar değil, günler.
Regülasyon Öngörüsü
5070 Kanun, KamuSM rehberi, ETSI standartları, LTA/A uzun dönem arşiv uyumu yerleşik olarak gelir. Denetim raporlarında bulgu olma riski asgariye iner.
Öngörülebilir TCO
İstemci yazılım lisansı, deployment maliyeti, versiyon yönetimi operasyonu yok. Fiyatlandırma imza hacmi bazlıdır, finansal planlama net.
📘 Derinlemesine karar rehberi: Proje takviminde gecikme, bütçe aşımı ve regülasyon riski analizlerinin detayı için E-İmza Entegrasyonu Yönetici Rehberi yazımıza göz atın.
Sıkça Sorulan Sorular
Aradığınız cevabı bulamadıysanız bize canlı chat veya e-posta ile ulaşabilirsiniz.
- primeAPI nedir?
- primeAPI, yazılım geliştiricilerin kendi uygulamalarına e-imza ve mobil imza atma özelliği eklemesini sağlayan bir REST API servisidir. ONAYLARIM altyapısı üzerinde çalışır; SDK kurulumu, Java bağımlılığı veya istemci yazılımı dağıtmak gerekmez.
- primeAPI bir SDK mıdır?
- Hayır. SDK'larda olduğu gibi size DLL veya JAR dosyaları teslim edilmez. primeAPI, REST API kullanarak e-imza atmanızı sağlar — backend'iniz hangi dilde olursa olsun (.NET, Java, Node.js, Python, Go, PHP) HTTP istekleri ile entegre olur.
- primeAPI tek başına kullanılabilir mi?
- Hem evet, hem hayır. primeAPI, ONAYLARIM altyapısını kullanarak imza atılmasını sağlar. Ancak imza atan kullanıcıların ONAYLARIM üyesi olmasına gerek yoktur — kendi uygulamanız üzerinden imza atmalarını sağlarsınız.
- primeAPI hangi e-imza standartlarını destekler?
- primeAPI ile CAdES (dosya imzası), PAdES (PDF imzası, görsel damga desteği), XAdES (XML imzası) profilleri kullanabilirsiniz. P1-P4 imza seviyeleri ve LTA/A uzun dönem arşiv imzası desteklenir. Zaman damgası TÜBİTAK ve BTK onaylı diğer sağlayıcılarla otomatik uygulanır.
- Test ortamı (sandbox) var mı?
- Evet. primeAPI test anahtarı ile sandbox ortamında gerçek belgeyle imza akışını deneyebilirsiniz. Canlıya geçiş için ayrı bir production anahtarı verilir. Test ve canlı ortam arasında geçiş tek header değişikliği ile olur — kod değişikliği gerekmez.
- Hangi e-imza sağlayıcılarıyla (ESHS) uyumludur?
- primeAPI, BTK onaylı tüm Elektronik Sertifika Hizmet Sağlayıcıları ile çalışır: KamuSM, TürkTrust, e-Güven, EBG, e-Tuğra. Mobil imza için Turkcell, Türk Telekom ve Vodafone desteklenir. Kullanıcının sertifika sağlayıcısı primeAPI entegrasyonunu etkilemez.
- primeAPI'yi nasıl satın alabilirim?
- İki kanal mevcut: (1) DMO Teknoloji Kataloğu üzerinden kamu kurumları için kurumsal alım, (2) doğrudan kurumsal satış üzerinden demo + özel teklif. Fiyatlandırma imza hacmi bazlıdır; test anahtarı ve entegrasyon desteği teklif sürecinde sağlanır.
- Destek ve SLA nasıl işliyor?
- Kurumsal müşterilere özel teknik destek hattı ve hesap yöneticisi sunulur. Entegrasyon aşamasında örnek kod, Postman koleksiyonu ve bire bir mühendis görüşmesi dahildir. Canlıda operasyonel sorun için kritik destek kanalı mevcuttur.