Pāriet uz galveno saturu
Izmanto šo ceļvedi, lai atrastu testēšanas vietu, izveidotu pierakstu pacienta profilam un pievienotu veicamos testu paneļus. Izpildi šīs darbības pirms pacienta ierašanās uz asins paņemšanu.
1

Pārlūkot pieejamās vietas

Iegūsti savā kontā pieejamo testēšanas vietu sarakstu, nosūtot GET pieprasījumu uz /api/v1/locations.
Atbilde ir vietu objektu masīvs:
Veidojot scheduled_at laikspiedolu, izmanto vietas objekta lauku timezone. Pieraksta laika pārvēršana vietas vietējā laika joslā palīdz izvairīties no pieraksta plānošanas ārpus darba laika.
Nenosaki pieejamos pieraksta laikus tikai pēc open_hours. Izsauc Iegūt pieejamību un rezervē tā atgriezto laika posma sākumu — šajā grafikā ir ņemti vērā arī esošie pieraksti, atsevišķu datumu izņēmumi un minimālais pieteikšanas laiks.
2

Izveidot pierakstu

Nosūti POST pieprasījumu uz /api/v1/appointments ar profila ID, vietas ID un vēlamo pieraksta laiku. Laikam jābūt laika posma sākumam no Iegūt pieejamību.
scheduled_at jābūt nākotnes datumam un laikam ISO 8601 formātā, piemēram, 2026-05-12T07:30:00Z. Laikspiedoli pagātnē tiek noraidīti ar 400 kļūdu, tāpat kā laiki, kas iekrīt 12 stundu minimālajā pieteikšanas laikā Aniva pārvaldītajās vietās.
Šo pieprasījumu var droši atkārtot. Profilam katrā vietā un laikā var būt tikai viens pieraksts, tāpēc atkārtoti vai divreiz nosūtīts izveides pieprasījums atgriež 409 ar esošo appointment_id, nevis pieraksta pacientu divreiz.
Veiksmīgs pieprasījums atgriež 201 Created ar pieraksta objektu:
Saglabā pieraksta id — tas būs nepieciešams paneļu pievienošanai un asins paņemšanas apstiprināšanai.
3

Pievienot testu paneļus

Pievieno testu paneļus, kurus vēlies veikt asins paraugam, nosūtot POST pieprasījumu uz /api/v1/appointments/{id}/panels.Paneļu ID ir UUID. Izsauc Iegūt paneļu sarakstu, lai iegūtu paneļus, kurus tava API atslēga var pasūtīt.
Pēc asins paņemšanas apstiprināšanas paneļus pievienot vairs nevar. Pievieno visus nepieciešamos paneļus pirms apstiprināšanas — sīkāku informāciju skati sadaļā Apstiprināt asins paņemšanu.
Veiksmīgs pieprasījums atgriež 200 OK, apstiprinot, ka paneļi ir pievienoti:

Pārplānošana vai atcelšana

Pēc pieraksta izveides to joprojām vari mainīt pirms asins paņemšanas apstiprināšanas:
  • Pārplānot vai mainīt vietu — nosūti PATCH pieprasījumu uz /api/v1/appointments/{id} ar atjaunināmajiem laukiem. Skati Atjaunināt pierakstu.
  • Atcelt — nosūti DELETE pieprasījumu uz /api/v1/appointments/{id}. Skati Atcelt pierakstu.
Abas darbības ir pieejamas tikai pirms asins paņemšanas — t. i., kamēr pierakstam ir statuss pending vai confirmed. Kad pieraksts pāriet statusā blood_drawn, nekādas turpmākas izmaiņas vairs nav iespējamas.

Kļūdu apstrāde