Vai al contenuto principale
Usa questa guida per creare un profilo paziente e assegnarlo al tuo gruppo di profili. I profili sono il punto di partenza per prenotare appuntamenti e avviare ordini di laboratorio.
1

Recupera il riferimento del tuo gruppo di profili

Ogni profilo deve essere assegnato a un gruppo di profili del tuo account partner. Il campo profile_group accetta l’UUID immutabile del gruppo o il suo slug leggibile — l’UUID è preferibile perché non cambia mai e resta valido anche se lo slug viene rinominato.Se non conosci il riferimento del tuo gruppo di profili, contatta Aniva per ottenerlo. Non puoi creare profili senza un riferimento valido.
2

Crea il profilo

Invia una richiesta POST a /api/v1/profiles con i dati anagrafici del paziente.
first_name e last_name sono entrambi obbligatori. Accettano solo lettere dell’alfabeto latino (incluse lettere accentate come ü), spazi, trattini e apostrofi. Traslittera i nomi in altri alfabeti prima di inviarli.
Se ometti email, Aniva genera automaticamente un indirizzo email segnaposto per il profilo. Puoi aggiornarlo in seguito con una richiesta PATCH.
Il campo language controlla la lingua che Aniva usa per comunicare con il paziente, ad esempio per i promemoria degli appuntamenti e le notifiche dei risultati. Impostalo in base alla lingua preferita del paziente. Crea profilo elenca i valori supportati. Il valore predefinito è en.
Una richiesta riuscita restituisce 201 Created con il nuovo oggetto profilo:
Salva l’id — ti servirà per prenotare appuntamenti e aggiornare il profilo.
3

Aggiorna il profilo (facoltativo)

Usa PATCH /api/v1/profiles/{id} per aggiornare qualsiasi campo del profilo dopo la creazione. Tutti i campi sono facoltativi — includi solo i campi che vuoi modificare.L’esempio seguente aggiunge un numero di telefono e l’altezza:
Una richiesta riuscita restituisce 200 OK con l’oggetto profilo aggiornato completo.

Gestione degli errori