SignaPort API Dokümantasyonu

SignaPort e-imza sistemi için REST API dokümantasyonu.

Genel Bilgiler

Base URL: https://api.signaport.com

API Versiyonu: v1

Authentication: JWT Bearer Token

Content-Type: application/json

Protokol: HTTPS (zorunlu)

Temel Kavramlar

Token Sistemi

SignaPort API, JWT (JSON Web Token) tabanlı authentication kullanır. İki tip token vardır:

• Access Token: Genel API erişimi için (15 dakika geçerlilik)
• Sign Token: İmzalama işlemi için (5 dakika geçerlilik, tek kullanımlık)

Quota (Kontör) Yönetimi

Her firma için satın alınan toplam kontör takip edilir. Her başarılı imzalama işleminde kontör düşer. Kontör hesaplaması:

Kalan Kontör = Satın Alınan Toplam - Kullanılan Toplam

İmza Tipleri

• 0: Medula (Sağlık Bakanlığı e-reçete sistemi)
• 1: İBYS (İlaç Bilgi Yönetim Sistemi)

API Endpoint'leri

Method	Endpoint	Açıklama
POST	/api/v1/auth/get-token	JWT token üretir
POST	/api/license/validate	Token doğrular, kontör düşürür
GET	/api/license/check-quota/{key}	Kalan kontör sorgular

Hızlı Başlangıç

1. Token Alın

curl -X POST https://api.signaport.com/api/v1/auth/get-token \
  -H "Content-Type: application/json" \
  -d '{
    "licenseKey": "TEST-KEY-12345",
    "password": "your-password",
    "imzaTipi": 0
  }'

2. İmza Yetkisi Alın

curl -X POST https://api.signaport.com/api/license/validate \
  -H "Content-Type: application/json" \
  -d '{
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "origin": "https://online.akareisg.com"
  }'

3. SignaPort ile İmzalayın

Token'ı SignaPort masaüstü uygulamasına gönderin.

Rate Limiting

API endpoint'leri dakika bazlı istek limitleri ile korunmaktadır:

Endpoint	Limit
get-token	10 istek/dakika
validate	100 istek/dakika
check-quota	20 istek/dakika

Limit aşıldığında HTTP 429 (Too Many Requests) döner.

Güvenlik

• Tüm API istekleri HTTPS üzerinden yapılmalıdır
• JWT token'lar HMAC-SHA256 ile imzalanır
• Token'lar tek kullanımlıktır
• Password'ler hash'lenerek saklanır
• CORS domain kontrolü yapılır
• Rate limiting uygulanır

Destek

E-posta: support@signaport.com

Web: https://signaport.com

Çalışma Saatleri: Hafta içi 09:00 - 18:00

---

© 2025 aKare Bilişim Hizmetleri A.Ş. Tüm hakları saklıdır.