Kanıt Paketleri API
GET /api/v1/evidence-packs/:id
Mevcut kanıt paketinin detayını okur; bu yol yeni paket oluşturmaz. Paket
kimliği ve sunucuda çözülen organizasyon kimliği birlikte sorgulanır.
Başka organizasyona ait veya bulunmayan paket için 404 döner.
Kimlik Doğrulama ve Yetki
| Kimlik doğrulama | Kural |
|---|---|
| API anahtarı | x-api-key; evidence-packs:read izni gerekir. Bu izin anahtar oluşturma veya izin güncelleme sırasında yalnız ENTERPRISE planına verilir |
| JWT | Authorization: Bearer <JWT>; yalnız ADMIN veya EDITOR rolü kabul edilir |
| Plan ve kota | Anahtar çağrısında publicApi özelliği ve planın hız sınırı; hem JWT hem anahtar çağrısında genel API kullanım kotası denetlenir |
JWT yolunda ayrıca bir ENTERPRISE plan kontrolü tanımlı değildir. Anahtar
izin politikası ile JWT rol kontrolü farklıdır. Geçerli abonelik ve
kullanılabilir kota gerekir.
Yol Parametreleri
| Parametre | Tip | Kural |
|---|---|---|
id | Metin | Mevcut paketin kimliği; controller UUID biçimi zorunlu tutmaz |
Bu işlem için bir sorgu DTO’su veya istek gövdesi tanımlı değildir.
Yanıt
Başarı durumu 200; yanıt { "success": true, "data": ... } zarfındadır.
data alanı | Tip / anlam |
|---|---|
id | Metin |
title | Metin veya null |
status | GENERATING, COMPLETED, FAILED |
periodStart, periodEnd | ISO 8601 tarih-saat |
checksum, manifestSignature | Metin veya null |
readinessSummary | Hazırlık özeti nesnesi veya null |
verificationAppendix | Doğrulama eki nesnesi veya null |
fileKey | Depolama anahtarı veya null; indirme URL’si değildir |
downloadUrl | İmzalı dosya URL’si veya null |
error | İşleme hatası metni veya null |
createdAt | ISO 8601 tarih-saat |
completedAt | ISO 8601 tarih-saat veya null |
downloadUrl, dosya anahtarı varsa 3600 saniyelik geçerlilik istenerek
üretilir; dosya yoksa veya imzalama başarısızsa null olur. Bu okuma yolunda
bağlantı üretimi ayrıca status=COMPLETED koşuluna bağlanmaz.
readinessSummary; generatedAt, regulationChangeSummary,
openEvidenceGaps, overdueActions, unsignedMandatoryReads,
trustRiskSummary, missingEvidenceCount, articleImpactLinks alanlarını
taşır. verificationAppendix; generatedAt, runs, results, exports
alanlarını taşır. checksum ve manifestSignature alanları bir dış denetim,
ISO sertifikası veya hukuki uygunluk garantisi olarak yorumlanmaz.
Hata Kodları
| HTTP durumu | Anlam |
|---|---|
401 | JWT/API anahtarı eksik veya geçersiz |
402 | Genel API kotası çözülürken abonelik bağlamı bulunamıyor |
403 | JWT rolü, anahtar/IP izni, plan özelliği veya kullanım kotası yetersiz |
404 | Paket bulunamadı veya organizasyon kapsamında değil |
429 | İstek hızı aşıldı; mevcutsa Retry-After süresine uyulur |
503 | API anahtarının hız sınırı denetimi kullanılamıyor |
Hatalar application/problem+json türünde döner. Ortak alanlar
Ortak API Kuralları sayfasındadır.
Örnekler
EVIDENCE_PACK_ID mevcut bir paket kimliği olmalıdır:
curl --fail-with-body "https://api.mevzuatradar.com/api/v1/evidence-packs/$EVIDENCE_PACK_ID" \
-H "x-api-key: $MEVZUATRADAR_API_KEY"