API referansı · 6 uç nokta
Admin · Slots
Haftalık slot şablonları ve somut teslimat slotları. ADMIN rolü gerekir.
GET
/v1/admin/slot-templates Bearer Haftalık slot şablonları
Yanıtlar
| Durum | Gövde | Açıklama |
|---|---|---|
| 200 | SlotTemplateDto[] | Şablon listesi. |
| 401 | ApiError | missing_token, invalid_token veya unauthenticated. |
| 403 | ApiError | insufficient_role — kimlik doğru, rol yetkili değil. |
POST
/v1/admin/slot-templates Bearer Şablon oluşturur
İstek gövdesi CreateSlotTemplateRequest
Yanıtlar
| Durum | Gövde | Açıklama |
|---|---|---|
| 201 | SlotTemplateDto | Oluşturuldu. |
| 400 | ApiError | validation_failed — gövde veya query şemaya uymuyor (details). |
| 401 | ApiError | missing_token, invalid_token veya unauthenticated. |
| 403 | ApiError | insufficient_role — kimlik doğru, rol yetkili değil. |
| 409 | ApiError | slot_template_overlap — aynı gün içinde çakışan şablon. |
PATCH
/v1/admin/slot-templates/{id} Bearer Şablonu günceller
İstek gövdesi UpdateSlotTemplateRequest
Yanıtlar
| Durum | Gövde | Açıklama |
|---|---|---|
| 200 | SlotTemplateDto | Güncel şablon. |
| 400 | ApiError | validation_failed — gövde veya query şemaya uymuyor (details). |
| 401 | ApiError | missing_token, invalid_token veya unauthenticated. |
| 403 | ApiError | insufficient_role — kimlik doğru, rol yetkili değil. |
| 404 | ApiError | slot_template_not_found. |
| 409 | ApiError | slot_template_overlap. |
DELETE
/v1/admin/slot-templates/{id} Bearer Şablonu pasife alır
Satır silinmez; güncel DTO döner.
Yanıtlar
| Durum | Gövde | Açıklama |
|---|---|---|
| 200 | SlotTemplateDto | Pasife alınmış şablon. |
| 401 | ApiError | missing_token, invalid_token veya unauthenticated. |
| 403 | ApiError | insufficient_role — kimlik doğru, rol yetkili değil. |
| 404 | ApiError | slot_template_not_found. |
GET
/v1/admin/slots Bearer Tarih aralığındaki somut slotlar
Bu çağrı aralığı okurken somutlaştırır: henüz oluşturulmamış günler için slotlar burada üretilir. Aralık en fazla 400 gün olabilir.
Parametreler
| Ad | Yer | Tip | Açıklama |
|---|---|---|---|
from * | query | string (date) | Europe/Istanbul takvim günü, dahil. |
to * | query | string (date) | Europe/Istanbul takvim günü, dahil. from'dan önce olamaz. |
Yanıtlar
| Durum | Gövde | Açıklama |
|---|---|---|
| 200 | DeliverySlotDto[] | Slot listesi. |
| 400 | ApiError | validation_failed veya slot_range_too_wide (yanıtta maxDays). |
| 401 | ApiError | missing_token, invalid_token veya unauthenticated. |
| 403 | ApiError | insufficient_role — kimlik doğru, rol yetkili değil. |
PATCH
/v1/admin/slots/{id} Bearer Tek slotu günceller
Kapasite, mevcut reservedCount'un altına çekilemez.
Parametreler
| Ad | Yer | Tip | Açıklama |
|---|---|---|---|
id * | path | string |
İstek gövdesi UpdateSlotRequest
Yanıtlar
| Durum | Gövde | Açıklama |
|---|---|---|
| 200 | DeliverySlotDto | Güncel slot. |
| 400 | ApiError | validation_failed — gövde veya query şemaya uymuyor (details). |
| 401 | ApiError | missing_token, invalid_token veya unauthenticated. |
| 403 | ApiError | insufficient_role — kimlik doğru, rol yetkili değil. |
| 404 | ApiError | slot_not_found (yanıtta slotId). |
| 409 | ApiError | slot_capacity_below_reserved. |