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

Yükümlülük Vadeleri API

GET /api/v1/deadlines

Aktif organizasyondaki silinmemiş, vadesi bulunan ve tamamlanmamış aksiyonları listeler. Bu liste mevzuat kaydındaki complianceDeadline alanından değil, aksiyonların dueDate alanından üretilir.

Kimlik Doğrulama ve Yetki

AlanKural
API anahtarıx-api-key; actions:read izni gerekir
JWTAuthorization: Bearer <JWT>; actions sayfası okuma izni denetlenir
JWT kayıt kapsamıVIEWER yalnız kendisine atanmış kayıtları; ADMIN, EDITOR, LEGAL_REVIEWER organizasyon kayıtlarını görür
OrganizasyonSunucuda kimlik doğrulama bağlamından çözülür; sorguda organizasyon seçilmez
Plan ve kotaAPI anahtarı için publicApi özelliği ve desteklenen plan gerekir; varsayılan plan kodları PROFESSIONAL, COMMERCIAL, ENTERPRISE olur. JWT ve anahtar çağrıları genel API kotasını tüketir

API anahtarı çağrılarına kullanıcıya atanma filtresi uygulanmaz.

Sorgu Parametreleri

Bütün parametreler isteğe bağlıdır. Tanımlanmamış alanlar 400 döner.

ParametreTip ve doğrulamaDavranış
pageTam sayı, en az 1Varsayılan 1
limitTam sayı, 1–100Varsayılan 20
priorityLOW, MEDIUM, HIGH, CRITICALÖncelik filtresi
dueDateFromISO 8601 tarih metniDahil edilen alt sınır; verilmezse sunucunun istek anındaki zamanı
dueDateToISO 8601 tarih metniDahil edilen üst sınır; verilmezse üst sınır yok
statusPENDING, IN_PROGRESS, COMPLETED, OVERDUE, CANCELLEDDTO kabul eder; bu uç noktada filtrelemeye uygulanmaz

Servis status değerinden bağımsız olarak COMPLETED ve CANCELLED durumlarını dışarıda bırakır. Yalnız PENDING kayıtlarını istemek için status=PENDING göndermek sonucu daraltmaz.

Varsayılan alt sınır günün başlangıcı değildir. Geçmiş vadeler için açık bir dueDateFrom gönderilir. OVERDUE durumundaki bir kayıt da ancak vadesi istenen aralığa uyuyorsa gelir. Tarih aralığı sırası ayrıca doğrulanmaz. Sıralama dueDate artan, ardından createdAt azalandır.

Yanıt

Başarı durumu 200 olur:

{ "success": true, "data": { "items": [], "total": 0, "page": 1, "limit": 20, "totalPages": 0 } }

Her kayıt id, title, description, priority, status, dueDate, regulationId, department, assignee, createdAt, updatedAt içerir. description ve department metin veya null; assignee ise { id, name, email } veya null olur. Bu uçta dueDate doludur. Tarihler ISO 8601 tarih-saat olarak iletilir.

Sayfalama alanları doğrudan data içindedir. Sonuç yokken totalPages=0, aksi durumda ceil(total / limit) olur. Alan açıklamaları İşlem Akışları API ile ortaktır.

Hata Kodları

HTTP durumuAnlam
400Geçersiz sorgu, enum, tarih veya sayfalama
401JWT/API anahtarı eksik veya geçersiz
402Genel API kotası çözülürken abonelik bağlamı bulunamıyor
403Anahtar/sayfa/IP izni, plan özelliği veya kullanım kotası yetersiz
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

curl --fail-with-body --get 'https://api.mevzuatradar.com/api/v1/deadlines' \ --data-urlencode 'priority=HIGH' \ --data-urlencode 'dueDateFrom=2026-10-01T00:00:00Z' \ --data-urlencode 'dueDateTo=2026-10-31T23:59:59Z' \ --data-urlencode 'limit=20' \ -H "x-api-key: $MEVZUATRADAR_API_KEY"

Kişisel alan izni

API anahtarıyla assignee kişi bilgisini (id, ad ve e-posta) almak için people:read izni gerekir. İzin yoksa assignee alanı yanıtta hiç bulunmaz; null yer tutucu dönmez. JWT yanıtı değişmez. Yeni anahtarlarda bu izin açıkça seçilir.