Saltar al contingut principal
PATCH
Afegeix un o més biomarcadors individuals a una cita com a proves a la carta, fora de qualsevol panell predefinit. Les decisions d’encaminament es prenen més endavant al flux de logística de comandes segons les correspondències per laboratori de cada biomarcador. El conjunt resultant es valida de manera síncrona segons les regles de tancament de cada laboratori. Alguns biomarcadors només es poden obtenir demanant-los juntament amb altres — una ràtio LDL/HDL, per exemple, s’obté amb una comanda que també retorna LDL i HDL, de manera que demanar la ràtio sola no és una comanda coherent. (Aquests mateixos components són els que determinen el preu de la ràtio — consulta el desglossament de pricing a Llista els biomarcadors.) Quan el conjunt no es pot demanar correctament, la crida retorna 400 amb una càrrega útil validation i no es desa res, de manera que pots anar provant fins a arribar a un conjunt vàlid:
  1. PATCH … { "biomarker_ids": [45] } (només la ràtio LDL/HDL) → 400; validation.failures[].fix_options[].add_biomarkers llista LDL i HDL.
  2. PATCH … { "biomarker_ids": [45, 43, 42] } (ràtio + LDL + HDL) → 200.
El mateix cicle cobreix els biomarcadors que Aniva ven només dins d’una posició: demana’n un de sol i la crida retorna 400 amb error: "biomarker_requires_position" i les posicions que el venen. Consulta Preus. Llista els biomarcadors indica alguns biomarcadors amb price_cents: null. Aquests biomarcadors no estan configurats: Aniva no els ha posat preu. Si n’afegeixes un, la crida retorna 400 amb error: "biomarker_not_priced". Cap altre biomarcador resol aquest error, perquè null vol dir que no tens cap preu per comprar el marcador. Els marcadors de kit en són l’excepció. Afegeix el panell que correspon al kit i els seus membres s’inclouen amb el panell. La crida també accepta un membre que afegeixis a una cita que ja inclou aquest panell. En una extracció capil·lar (draw_method: capillary), l’extracció s’envasa en microtubs. Els panells van primer, per ordre de reserva. Després, els biomarcadors individuals omplen l’espai lliure dels microtubs dels panells. Quan necessiten més espai, obren microtubs nous. Els repartim de manera uniforme. Cada microtub admet com a màxim 150 µl de biomarcadors individuals. Un biomarcador que necessiti més de 150 µl en un microtub propi no hi cap mai, i tampoc un biomarcador sense un volum configurat. Si el conjunt resultant incompleix aquesta regla, la crida retorna 400 amb un missatge error i no es desa res. Aquesta crida és idempotent: els biomarcadors que ja són a la cita es mantenen. Requereix els abasts appointments_schedule i schedule_appointments_with_individual_biomarker_selection.
No es poden afegir biomarcadors després de cridar Confirma l’extracció de sang. Intentar modificar una cita confirmada retorna 409 Conflict.

Sol·licitud

Paràmetres de ruta

string
requerit
Identificador únic (UUID) de la cita.

Paràmetres del cos

number[]
requerit
Matriu d’ID de biomarcadors per afegir. Ha de contenir almenys un element. Fes servir Llista els biomarcadors per trobar els ID.

Resposta

Si té èxit, l’API retorna 200 OK per confirmar que els biomarcadors s’han afegit.
boolean
true quan els biomarcadors s’han afegit correctament a la cita.

Com interpretar un 400

Cada 400 de validació de tancament o de catàleg inclou una frase a message. Un 400 de validació del cos o de microtub inclou només error. Ramifica segons error. En un error de validació de tancament, error és una frase. En un error de catàleg, error és un codi de màquina: biomarker_not_priced o biomarker_requires_position. Validació de tancament — el conjunt no es pot demanar correctament a cap laboratori:
  • validation.failures[] — present només en errors de validació de tancament (absent en errors simples de validació del cos). Una entrada per cada grup de biomarcadors que cap laboratori pot servir, amb els biomarker_ids que han fallat i fix_options[], començant per l’opció més petita. El camp add_biomarkers ({ id, name }) de cada opció és un conjunt que has d’afegir SENCER — mantén els originals, afegeix aquests i torna-ho a provar. Un fix_options buit vol dir que no servirà de res afegir-hi res més; elimina el biomarcador.
Biomarcador sense preu — Aniva no ha posat preu a aquest biomarcador. Llista els biomarcadors l’indica amb price_cents: null, o l’omet quan és una ràtio amb un component sense preu. error és biomarker_not_priced, i biomarker_id indica el marcador. Cap altre biomarcador resol aquest error, així que elimina el biomarcador. Dues condicions fan que un biomarcador es pugui demanar: un laboratori al qual Aniva pugui encaminar-lo l’ha d’oferir, i el catàleg d’Aniva li ha de posar preu. Biomarcador restringit — un biomarcador que es ven només dins d’una posició, sense cap posició que el cobreixi al conjunt. error és biomarker_requires_position, biomarker_id indica el marcador i positions[] llista totes les posicions que el venen, començant per la més econòmica. Afegeix tots els biomarcadors d’una d’elles. Consulta Preus per veure el model, i pricing.positions a Obtén un biomarcador per veure el conjunt complet de membres d’una posició.

Respostes d’error