Sağlık
Sağlık uçları: parametreler, alanlar ve örnek yanıtlar.
Geliştirici belgesi
- GET
/api/v1/health/duty-roster - GET
/api/v1/health/physician-availability - POST
/api/v1/health/physician-premiums
Nöbet listesini döndürür (hangi personel hangi gün hangi nöbette ya da çalışma saatinde)
GET /api/v1/health/duty-roster
Kapsam: health_scheduling:read
Şirketin seçilen günlerdeki etkin nöbet ve çalışma atamaları; Sağlık › Raporlar ekranındaki HBYS nöbet listesi dosyasıyla aynı satırlar. Eşleme anahtarı planlama kartının personel kodudur; T.C. kimlik no dönmez. Anahtarın rolü planlama kartını görmüyorsa staff_code null'dır. Aralık en çok 31 gündür. Sıra kimliğe göredir; örnek kayıtlar listeye girmez.
Parametreler
| Alan | Tür | Açıklama |
|---|---|---|
company_ (sorgu) | string (uuid)zorunlu | Şirket. Anahtarın kapsamında değilse liste boştur. |
employee_ (sorgu) | string (uuid) | Yalnız bu çalışan. |
from (sorgu) | string (date)zorunlu | İlk gün (YYYY-MM-DD). |
org_ (sorgu) | string (uuid) | Yalnız bu birimdeki kişiler (kişinin bugünkü birimi). |
to (sorgu) | string (date)zorunlu | Son gün (YYYY-MM-DD), from ile en çok 31 gün. |
cursor (sorgu) | string | Önceki yanıtın next_cursor değeri. Opaktır; aynı anahtarla ve aynı süzgeçle gönderilir. |
limit (sorgu) | integer | Sayfa boyutu; azamiyi aşan değer azamiye iner. |
Yanıtlar
200 Başarılı
Liste yanıtı { data, next_cursor } zarfındadır.
| Alan | Tür | Açıklama |
|---|---|---|
id | string (uuid)zorunlu | |
company_ | string (uuid)zorunlu | |
employee_ | string (uuid)zorunlu | |
staff_ | stringzorunlunull olabilir | Planlama kartındaki personel kodu (kurumun kendi kodu); rol planlama kartını görmüyorsa null. |
first_ | stringzorunlu | |
last_ | stringzorunlu | |
job_ | stringzorunlunull olabilir | |
unit | stringzorunlunull olabilir | Kişinin bugünkü birimi. |
date | string (date)zorunlu | Atamanın başladığı gün. |
shift_ | stringzorunlu | |
shift_ | stringzorunlu | |
shift_ | stringzorunlu | duty24: 24 saatlik nöbet, on_call: icap, normal, flexible, half. Değerler: normal, duty24, on_call, flexible, half |
start_ | stringzorunlu | |
end_ | stringzorunlu | Bitiş saati (SS:DD); başlangıçtan küçük ya da eşitse ertesi gündür. |
Örnek yanıt
{
"data": [
{
"id": "5c4b3a29-1807-4f6e-9d5c-4b3a29180706",
"company_id": "0b8f6c1e-5f0a-4c7e-9a43-2f6f3a1d9c10",
"employee_id": "3f2b1c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
"staff_code": "DR-0042",
"first_name": "Deniz",
"last_name": "Kaya",
"job_title": "Uzman Hekim",
"unit": "Acil Servis",
"date": "2026-12-02",
"shift_code": "N24",
"shift_name": "24 saat nobet",
"shift_kind": "duty24",
"start_time": "08:00",
"end_time": "08:00"
}
],
"next_cursor": null
}Hata kodları
400:bad_request,validation_failed,key_in_query,cookie_with_key,idempotency_key_required,idempotency_key_invalid,cursor_invalid401:unauthorized403:insufficient_scope,forbidden,module_disabled,trial_ended,key_suspended404:not_found429:rate_limited500:internal_error503:timeout
Hekim uygunluğunu FHIR Slot durumlarıyla döndürür
GET /api/v1/health/physician-availability
Kapsam: health_scheduling:read
Personel kodu olan her hekim için seçilen günleri boşluksuz aralıklara böler: busy-unavailable (onaylı izin, nöbet ya da icap), busy-tentative (onay bekleyen izin), free. İzin türü, tanı, not ve T.C. kimlik no dönmez. Anahtarın rolü planlama kartını ya da izni göremediği kişiyi listelemez; hiç göremiyorsa 403. Aralık en çok 31 gündür; sınırlar kiracının saat dilimindedir.
Parametreler
| Alan | Tür | Açıklama |
|---|---|---|
company_ (sorgu) | string (uuid) | Yalnız bu şirketin hekimleri. |
employee_ (sorgu) | string (uuid) | Yalnız bu hekim. |
from (sorgu) | string (date)zorunlu | İlk gün (YYYY-MM-DD). |
to (sorgu) | string (date)zorunlu | Son gün (YYYY-MM-DD), from ile en çok 31 gün. |
cursor (sorgu) | string | Önceki yanıtın next_cursor değeri. Opaktır; aynı anahtarla ve aynı süzgeçle gönderilir. |
limit (sorgu) | integer | Sayfa boyutu; azamiyi aşan değer azamiye iner. |
Yanıtlar
200 Başarılı
Liste yanıtı { data, next_cursor } zarfındadır.
| Alan | Tür | Açıklama |
|---|---|---|
employee_ | string (uuid)zorunlu | |
company_ | string (uuid)zorunlu | |
staff_ | stringzorunlu | Planlama kartındaki personel kodu. |
slots | object[]zorunlu | Aralıklar: başlangıç, bitiş (UTC) ve FHIR Slot durumu (free, busy-unavailable, busy-tentative). |
Örnek yanıt
{
"data": [
{
"employee_id": "3f2b1c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
"company_id": "0b8f6c1e-5f0a-4c7e-9a43-2f6f3a1d9c10",
"staff_code": "DR-0042",
"slots": [
{
"start": "2026-12-01T21:00:00.000Z",
"end": "2026-12-02T05:00:00.000Z",
"status": "free"
},
{
"start": "2026-12-02T05:00:00.000Z",
"end": "2026-12-03T05:00:00.000Z",
"status": "busy-unavailable"
},
{
"start": "2026-12-03T05:00:00.000Z",
"end": "2026-12-03T21:00:00.000Z",
"status": "busy-tentative"
}
]
}
],
"next_cursor": null
}Hata kodları
400:bad_request,validation_failed,key_in_query,cookie_with_key,idempotency_key_required,idempotency_key_invalid,cursor_invalid401:unauthorized403:insufficient_scope,forbidden,module_disabled,trial_ended,key_suspended404:not_found429:rate_limited500:internal_error503:timeout