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
| Alan | Kural |
|---|---|
| API anahtarı | x-api-key; actions:read izni gerekir |
| JWT | Authorization: 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 |
| Organizasyon | Sunucuda kimlik doğrulama bağlamından çözülür; sorguda organizasyon seçilmez |
| Plan ve kota | API 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.
| Parametre | Tip ve doğrulama | Davranış |
|---|---|---|
page | Tam sayı, en az 1 | Varsayılan 1 |
limit | Tam sayı, 1–100 | Varsayılan 20 |
priority | LOW, MEDIUM, HIGH, CRITICAL | Öncelik filtresi |
dueDateFrom | ISO 8601 tarih metni | Dahil edilen alt sınır; verilmezse sunucunun istek anındaki zamanı |
dueDateTo | ISO 8601 tarih metni | Dahil edilen üst sınır; verilmezse üst sınır yok |
status | PENDING, IN_PROGRESS, COMPLETED, OVERDUE, CANCELLED | DTO 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 durumu | Anlam |
|---|---|
400 | Geçersiz sorgu, enum, tarih veya sayfalama |
401 | JWT/API anahtarı eksik veya geçersiz |
402 | Genel API kotası çözülürken abonelik bağlamı bulunamıyor |
403 | Anahtar/sayfa/IP izni, plan özelliği veya kullanım kotası yetersiz |
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
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.