Ana içeriğe geç
Mevzuat RadarDokümantasyon
Uygulamaya git ↗

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ğrulamaKural
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
JWTAuthorization: Bearer <JWT>; yalnız ADMIN veya EDITOR rolü kabul edilir
Plan ve kotaAnahtar ç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

ParametreTipKural
idMetinMevcut 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
idMetin
titleMetin veya null
statusGENERATING, COMPLETED, FAILED
periodStart, periodEndISO 8601 tarih-saat
checksum, manifestSignatureMetin veya null
readinessSummaryHazırlık özeti nesnesi veya null
verificationAppendixDoğrulama eki nesnesi veya null
fileKeyDepolama anahtarı veya null; indirme URL’si değildir
downloadUrlİmzalı dosya URL’si veya null
errorİşleme hatası metni veya null
createdAtISO 8601 tarih-saat
completedAtISO 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 durumuAnlam
401JWT/API anahtarı eksik veya geçersiz
402Genel API kotası çözülürken abonelik bağlamı bulunamıyor
403JWT rolü, anahtar/IP izni, plan özelliği veya kullanım kotası yetersiz
404Paket bulunamadı veya organizasyon kapsamında değil
429İstek hızı aşıldı; mevcutsa Retry-After süresine uyulur
503API 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"