Pāriet uz galveno saturu
POST
Ieplāno asins paņemšanas pierakstu pacienta profilam konkrētā testēšanas vietā. Pēc izveides pieraksts pēc noklusējuma iegūst statusu confirmed (dažās vietās noklusējuma statuss var būt pending — tas ir katras vietas iestatījums). Izmanto Pievienot paneļus, lai piesaistītu asins analīžu paneļus pirms asins paņemšanas apstiprināšanas.
Profilam var būt ne vairāk kā viens pieraksts vienā vietā un laikā. Izveidojot pierakstu laikā, kuru profils jau aizņem, otra pieraksta vietā tiek atgriezts 409 ar esošo appointment_id — tāpēc atkārtots vai nejauši dublēts pieprasījums nekad neizveidos dubultu pierakstu. Skati Dublēti pieraksti.
Nosūti neobligātu Idempotency-Key galveni, lai šo izveides pieprasījumu varētu droši atkārtot — atkārtojot to pašu atslēgu, tiek atgriezta sākotnējā atbilde, nevis izveidots otrs pieraksts. Skati Idempotence. Nepieciešams piekļuves tvērums appointments_schedule.

Pieprasījums

Pieprasījuma satura parametri

string
obligāts
Pacienta profila UUID, kuram izveidot pierakstu.
string
obligāts
Testēšanas vietas UUID, kur notiks asins paņemšana. Izmanto Vietu saraksts, lai atrastu pieejamos vietu ID.
string
obligāts
Pieraksta datums un laiks ISO 8601 formātā (piem., 2026-05-15T10:30:00Z vai 2026-05-15T12:30:00+02:00). Jāiekļauj laika joslas norāde — Z vai skaidra nobīde, piemēram, +02:00; datumi bez laika joslas tiek noraidīti. Jābūt nākotnē.Tam jāatbilst precīzam laika intervāla sākumam vietas grafikā, un tajā vēl jābūt brīvām vietām — vispirms skati Iegūt pieejamību. Grafikam neatbilstoši laiki atgriež 400; aizpildīts laika intervāls atgriež 409. Aniva pārvaldītajās vietās tam jābūt arī vismaz 12 stundas uz priekšu — skati Minimālais pieteikšanas laiks.
string[]
Līdz 5 adresēm, no kurām katra saņem vienu e-pastu, kad visi laboratorijas rezultāti ir galīgi. E-pastā ir saite uz rezultātu lapu Aniva administrēšanas panelī. Tavai atslēgai nepieciešama results_view piekļuve pacientam, pretējā gadījumā tiks atgriezts 403. Izlaid šo lauku, lai izmantotu pacienta grupai iestatītās noklusējuma adreses. Tukšs saraksts izslēdz šos e-pastus. Skati E-pasti par gataviem rezultātiem.
string
Asins paņemšanas metode: capillary vai venous. Izlaid šo lauku, lai izmantotu vietas default_draw_method. Vietai šī metode ir jānorāda savā draw_methods sarakstā, pretējā gadījumā tiks atgriezts 400.

Atbilde

Veiksmīgā gadījumā API atgriež 201 Created ar jauno pierakstu.
string
obligāts
Unikāls pieraksta identifikators (UUID).
string
obligāts
Profila UUID, kuram pieder šis pieraksts.
string
Analīžu vietas UUID, kur notiek asins paņemšana.
string
Ieplānotais pieraksta datums un laiks UTC formātā (ISO 8601 ar Z piedēkli, piem., 2026-05-15T10:30:00Z). Var būt null.
string
obligāts
Pašreizējais pieraksta statuss. Viens no: pending, confirmed, blood_drawn vai cancelled. Detalizētu laboratorijas rezultātu gatavības informāciju var iegūt ar Iegūt rezultātus; detalizētāku sūtījuma gaitu — no katra ieraksta iebūvētajā shipments masīvā (skati zemāk), tālāk izmantojot Iegūt sūtījumu.
string
Brīva teksta iemesls, kas fiksēts pieraksta atcelšanas brīdī (piem., neierašanās, vēla atcelšana, ‘Neizdevās. Nepieciešams atkārtot’). Ir null, ja vien status nav cancelled.
string[]
obligāts
Adreses mazajiem burtiem, no kurām katra saņem vienu e-pastu, tiklīdz visi laboratorijas rezultāti ir galīgi. Tukšs, kad izslēgts. Skatīt E-pasti par gataviem rezultātiem.
string
obligāts
Asins paņemšanas metode: capillary (no pirksta gala vai augšdelma mikrostobriņos) vai venous (no vēnas stobriņos). Tā ir metode, ko nosaka pieraksts, vai arī tā vietas default_draw_method. Pēc asins paņemšanas tā ir izmantotā metode.
object
obligāts
Ar šo pierakstu saistītais pacienta profils.
AppointmentPanel[]
obligāts
Paneļi, kas pašlaik piesaistīti šim pierakstam. Jaunizveidotiem pierakstiem šis saraksts ir tukšs — pievieno ar Pievienot paneļus. Paneļu informāciju (nosaukumu, biomarķierus) skati ar Paneļu saraksts.
AppointmentIndividualBiomarker[]
obligāts
Atsevišķie biomarķieri, kas piesaistīti šim pierakstam ārpus paneļiem. Jaunizveidotiem pierakstiem šis saraksts ir tukšs — pievieno ar Pievienot atsevišķus biomarķierus. Katru biomarker_id salīdzini ar Biomarķieru saraksts, lai iegūtu attēlošanas datus.
AppointmentShipmentLink[]
obligāts
Šim pierakstam piesaistītie sūtījumi, sākot ar vecāko piesaisti. Jaunizveidotiem pierakstiem šis saraksts ir tukšs — piesaisti ar Izveidot sūtījumu (norādot appointment_id) vai Piesaistīt pierakstus sūtījumam.
string[]
obligāts
Šim pierakstam reģistrētie laboratorijas kodi (stobriņu svītrkodi) skenēšanas secībā. Tukšs, līdz asins paņemšana ir apstiprināta. Venozai asins paņemšanai ir viens kods, kas uzdrukāts uz katra stobriņa; kapilārai asins paņemšanai ir viens kods katram mikrostobriņam. Rezultāti un dokumenti sadaļā Iegūt rezultātus atsaucas uz šiem kodiem ar lab_code.

Minimālais pieteikšanas laiks

Pieraksti Aniva pārvaldītajās vietās jāpiesaka vismaz 12 stundas iepriekš; pieteikšana šajā laika logā atgriež 400. Iegūt pieejamību jau neiekļauj šos laika intervālus, tāpēc visu, ko redzi šajā grafikā, var pieteikt. Tevis pārvaldītajām vietām minimālā pieteikšanas laika nav — pieteikšana tajā pašā dienā un bez iepriekšēja pieraksta paliek nemainīga.

Dublēti pieraksti

Profilam var būt ne vairāk kā viens neatcelts pieraksts vienā vietā un vienā brīdī — vienai personai nevar veikt asins paņemšanu divreiz vienā vietā un vienā mirklī, neatkarīgi no tā, cik krēslu ir šajā vietā. Izveidojot pierakstu laikā, kuru profils jau aizņem, tiek atgriezts 409 ar appointment_id, kas norāda jau esošo pierakstu:
Apstrādā to, uzskatot pieprasījumu par jau izpildītu: iegūsti pierakstu ar Iegūt pierakstu, pārcel to ar Atjaunināt pierakstu vai atcel to ar Atcelt pierakstu. Neatkārto izveides pieprasījumu — tas turpinās atgriezt 409. Tas padara atkārtotus izveides pieprasījumus drošus: pieprasījums, ko nosūti atkārtoti pēc noildzes, vai divreiz iesniegta forma nevar izveidot divus pierakstus vienam pacientam vienā un tajā pašā laikā.
appointment_id tiek atgriezts tikai dublēta pieraksta 409 atbildē. Ietilpības 409 — kad laika intervāls ir pilns, jo to aizņem citi pacienti — atgriež tikai error, un pareizais risinājums šādā gadījumā ir izvēlēties citu laiku no Iegūt pieejamību.

Kļūdu atbildes