Skip to content

xale76/Visitami-API

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

41 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Paginemediche - servizio Visitami-API

Visitami API versione 0.10.8.27

Questo progetto contiene l'elenco delle funzionalità per l'integrazione con le API Visitami e un codice di esempio da usare come guida per le chiamate in PHP.

Prerequisiti

a) Concordare per l'acquisizione di un Token Applicazione;

b) Comunicare la URL certificata (https) da cui far provenire le richieste in modo che questa venga aggiunta alle URL per cui esiste un grant per le API;

c) Definire una propria pagina in cui ospitare il Widget Dinamico di prenotazione Visitami;

d) Conoscere ed eventualmente mappare le Categorie di Prestazioni presenti su Visitami;

Url API

Esistono 2 url, uno di sviluppo e l'altro di produzione:

Sviluppo https://demo.visitamiapp.com/app_api_web/genApi.asmx (possibile visionare WSDL)

Produzione https://www.visitamiapp.com/app_api_web/genApi.asmx (WSDL bloccato)

Chiamate API

Tutte le chiamate API prevedono una chiamata SOAP/Ajax con il passaggio di un token (alcune prevedono il passaggio del Token Applicazione, altre del Token Utilizzo) come parte dell'Header SOAP. Tutte le chiamate restituiscono JSON.

vedere esempio nel file token.php

Ricavare il Token Utilizzo (necessario possedere Token Applicazione)

Il Token Applicazione identifica univocamente l'applicazione che invoca le API e viene consegnato da Visitami al partner. Attraverso il Token Applicazione è possibile ottenere e rinnovare il Token Utilizzo, tramite il quale chiamare le API. Il Token Utilizzo ha una scadenza di 30 giorni, dopo i quali va rinnovato.

Public Function APIGEN_TokenRenew(ByRef lErr As String) As String
  • lErr (out) = parametro in uscita valorizzato con l'eventuale errore se il metodo ritorna emtpystring

Questa chiamata produrrà un JSON di questo tipo:

{"token":"<TOKEN UTILIZZO>","issued":1497,"validuntil":1527,"UTCdatetime":"20190308"}
  • Token = Token Utilizzo per le successive chiamate API
  • issued = id del giorno di richiesta
  • validuntil = id del giorno di fine validità
  • UTCdatetime= data ultimo giorno di validità nel formato yyyyMMdd

TUTTE LE CHIAMATE DA QUESTO PUNTO IN POI NECESSITANO DEL TOKEN DI UTILIZZO DA PASSARE NELL'HEADER

Ricavare Città

E' previsto un metodo per ricavare l'elenco delle Città di copertura del servizio Visitami abilitate alle API:

Public Function APIGEN_GetCitta(ByRef lErr As String) As String
  • lErr (out) = parametro in uscita valorizzato con l'eventuale errore se il metodo ritorna emtpystring

Questa chiamata produrrà un JSON di questo tipo:

[{"nome":"Milano","lat":"45.4642035","lng":"9.189982","codice":"MI-1","raggio":15}]
  • nome = nome della Città da mostrare
  • lat = latitudine
  • lng = longitudine
  • codice = Codice Univoco che identifica la città
  • raggio = raggio in Km di copertura a partire dalle coordinate gps

vedere esempio nel file ricerca.php

Ricavare Elenco delle Categorie di Prestazioni

E' previsto un metodo per ricavare l'elenco delle Categorie di Prestazioni presenti su Visitami:

Public Function APIGEN_GetCategorie(ByRef lErr As String) As String
  • lErr (out) = parametro in uscita valorizzato con l'eventuale errore se il metodo ritorna emtpystring

Questa chiamata produrrà un JSON di questo tipo:

[{"IdCategoria":56,"Nome":"Agopuntore"},{"IdCategoria":10,"Nome":"Allergologo-Immunologo"},{"IdCategoria":53,"Nome":"Andrologo"},{"IdCategoria":11,"Nome":"Angiologo-Chirurgo Vascolare"},....]
  • IdCategoria = Id univoco Categoria Prestazioni
  • Nome = nome della categoria da mostrare

vedere esempio nel file ricerca.php

Ricerca dei Professionisti (Semplice)

Questo metodo restituisce l'elenco dei professionisti disponibili per una data categoria in studio. In questa versione di API non è prevista la ricerca a domicilio. L'elenco del professionisti restituiti mostra solo la prima disponibilità per la prestazione base della categoria prestazioni richiesta (ad es. se categoria = "Medico Generico", prestazione di base = "Visita medica generica" etc). L'elenco restituito è ordinato per prima disponibilità.

Public Function APIGEN_DoSearchSimpleV2(ByVal idcate As Integer, ByVal codCitta As String, ByVal video as Boolean, ByRef lErr As String) As String
  • idcate = Id univoco Categoria Prestazioni
  • codCitta = Codice Univoco che identifica la città (passare stringa vuota per prestazioni video)
  • video = true o false a seconda se bisogna ricercare una prestazione video oppure dal vivo
  • lErr (out) = parametro in uscita valorizzato con l'eventuale errore se il metodo ritorna emtpystring

Questa chiamata produrrà un JSON di questo tipo:

[{"Nome":"Francesco Bianchi","Tit":"Dr.","Specializzazione":"medico generico","Sesso":"M","UrlImmagine":"https://demo.visitamiapp.com/getpic?MaxWidth=80\u0026PicID=!PROF@1117:med\u0026Token=TXRCdHoycklSUVl3V1ZrTDhCcFp3UVVWaDg1c0szcGR2b2YyQjFVd1M5ND0=\u0026MyToken=TXRCdHoycklSUVl3V1ZrTDhCcFp3UVVWaDg1c0szcGR2b2YyQjFVd1M5ND0=","Valutazione":3.1,"TokenProf":"TXRCdHoycklSUVl3V1ZrTDhCcFp3UVVWaDg1c0szcGR2b2YyQjFVd1M5ND0=","IDVisitami":1117,"IdPrestazione":184,"PrimaDisponibilita":{"IdDay":1497,"IdHour":77,"Data":"OGGI","Ora":"19:00","Luogo":"Studio a Milano zona Barona","Indirizzo":"Viale Famagosta, 50, Milano, 20142 MI","IdLuogo":4938,"Tariffa":"200-250 €","TariffaScontata":"140-175 €","Distanza":3.6,"Sconto":"-30%","ScontoD":0.3}},....]
  • Nome = Nome e Cognome del professionista o Nome della Struttura
  • Tit = Titolo (Dr./Prof. o vuoto)
  • Specializzazione = Nome della specializzazione principale
  • Sesso = M/F/S ( S=struttura)
  • UrlImmagine = URL dell'immagine del professionista/struttura
  • Valutazione = Rating (da 1 a 5). Valore -1 = nessuna valutazione espressa
  • TokenProf = Token Professioinsta da utilizzare nel Widget dinamico
  • IDVisitami = Id univoco Professionista in Visitami
  • IdPrestazione = Id univoco della Prestazione in Visitami
  • PrimaDisponibilita = classe che esprime la prima disponiblità del professionista:
    • IdIday = Id del giorno di prima disponibilità
    • IdHour = Id dell'ora di prima disponibilità
    • Data = Data della prima disponibilità
    • Ora = Ora della prima disponibilità
    • Luogo = Descrizione del luogo dell'appuntamento
    • Indirizzo = Indirizzo per esteso del luogo dell'appuntamento
    • IdLuogo = Id univoco del luogo
    • Tariffa = Tariffa prevista per la prestazione. Le tariffe sono espresse in € e possono essere variabili (per es. 50-70€)
    • TariffaScontata = Se presente uno sconto, rappresenta il prezzo che pagherà il paziente
    • Sconto = Label che rappresenta lo Sconto % eventualmente applicato
    • ScontoD = Valore decimale dello sconto applicato. 0=nessuno sconto
    • Distanza = Distanza del luogo dal centro di ricerca individuato da Lat e Lng

vedere esempio nel file ricerca.php

Ricerca dei Professionisti Paginata (Semplice)

Questo metodo restituisce lo stesso elenco di professionisti previsto per il metodo APIGEN_DoSearchSimple ma diviso per pagine, ciascuna contenente 10 risultati.

Public Function APIGEN_DoSearchSimplePagV2(ByVal idcate As Integer, ByVal codCitta As String, ByVal pindex As Integer, ByRef totpages As Integer, ByVal video as Boolean, ByRef lErr As String) As String
  • idcate = Id univoco Categoria Prestazioni
  • codCitta = Codice Univoco che identifica la città (passare stringa vuota nel caso di ricerca video)
  • pindex = indice di pagina (basata 0, per cui 0=prima pagina, 1=seconda pagina ...)
  • totpages (out) = restituisce il numero di pagine della ricerca
  • video = true o false a seconda se bisogna ricercare una prestazione video oppure dal vivo
  • lErr (out) = parametro in uscita valorizzato con l'eventuale errore se il metodo ritorna emtpystring

Questa chiamata produrrà un JSON uguale al relativo metodo non paginato.

Ricerca dei Professionisti

E' possibile invocare questa API specificando le coordinate GPS anzichè la città

Public Function APIGEN_DoSearchV2(ByVal idcate As Integer, ByVal lat As String, ByVal lng As String, ByVal km as integer, ByVal video as Boolean, ByRef lErr As String) As String
  • idcate = Id univoco Categoria Prestazioni
  • lat = stringa della latitudine (usare ".", es. "45.12312312" o stringa vuota per ricerca video)
  • lng = stringa della longitudine (usare ".", es. "9.12312312" o stringa vuota per ricerca video)
  • km = raggio di ricerca in Km (passare 0 per ricerca video)
  • video = true o false a seconda se bisogna ricercare una prestazione video oppure dal vivo
  • lErr (out) = parametro in uscita valorizzato con l'eventuale errore se il metodo ritorna emtpystring

La chiamata produrrà il JSON della chiamata Ricercare Professionisti (Semplice)

Ricerca dei Professionisti Paginata

Questo metodo restituisce lo stesso elenco di professionisti previsto per il metodo APIGEN_DoSearch ma diviso per pagine, ciascuna contenente 10 risultati.

Public Function APIGEN_DoSearchPagV2(ByVal idcate As Integer, ByVal lat As String, ByVal lng As String, ByVal km as integer, ByVal pindex As Integer, ByRef totpages As Integer, ByVal video as Boolean, ByRef lErr As String) As String
  • idcate = Id univoco Categoria Prestazioni
  • lat = stringa della latitudine (usare ".", es. "45.12312312" o stringa vuota per ricerca video)
  • lng = stringa della longitudine (usare ".", es. "9.12312312" o stringa vuota per ricerca video)
  • km = raggio di ricerca in Km (passare 0 per ricerca video)
  • pindex = indice di pagina (basata 0, per cui 0=prima pagina, 1=seconda pagina ...)
  • totpages (out) = restituisce il numero di pagine della ricerca
  • video = true o false a seconda se bisogna ricercare una prestazione video oppure dal vivo
  • lErr (out) = parametro in uscita valorizzato con l'eventuale errore se il metodo ritorna emtpystring

Questa chiamata produrrà un JSON uguale al relativo metodo non paginato.

Creazione Utente (Paziente)

Questo metodo serve per creare una corrispondenza tra utente dell'applicazione chiamante ed utente (paziente) di Visitami. Questo metodo restituisce il Token User univoco del paziente su Visitami e dovrà essere salvato nell'applicazione richiedente (legame tra applicazione richiedente e Visitami) e usato ove richiesto nei successivi metodi.

Se viene riconosciuta una corrispondenza tra dati passati e dati già presenti su Visitami, non verrà creata una nuova posizione, ma verrà restituita la posizione trovata.

NB: il passaggio di dati da applicazione richiedente a Visitami prevede una gestione della titolarità dei dati passati. In particolare: un Utente non presente in Visitami verrà marcato su Visitami come proveniente da applicazione richiedente a cui spetta la titolarità dei dati. Una richiesta di cancellazione su applicazione richiedente implica una cancellazione dei dati su Visitami secondo quanto regolato dalla Privacy Policy indicata all'indirizzo https://www.visitamiapp.com/note-legali. Per un utente in queste condizioni che acceda indipendentemente a Visitami, accettettando esplicitamente la suddetta privacy policy, verrà predisposto un aggiornamento della marcatura a "Cogestito", ossia presente in entrambe le piattaforme; un Utente già presente in Visitami verrà marcato come "Cogestito" in termini di titolarità. Una cancellazione su applicazione richiedente implicherà la cancellazione del legame tra applicazione richiedente e Visitami e il relativo aggiornamento della marcatura a "Solo Visitami", ma non la cancellazione su Visitami.

 Public Function APIGEN_NewUser(ByVal nome As String, ByVal cognome As String, ByVal email As String, ByVal phone As String, ByRef lErr As String) As String
  • nome = Nome del Paziente
  • cognome = Cognome del Paziente
  • email = Email del Paziente (campo chiave su cui viene ricercata la presenza in Visitami)
  • phone = Telefono del Paziente (opzionale, verrà comunque richiesto prima della prenotazione su Widget Dinamico). Può essere usato per ricercare la presenza in Visitami.
  • lErr (out) = parametro in uscita valorizzato con l'eventuale errore se il metodo ritorna emtpystring

La chiamata produrrà un JSON contenente il Token di accesso (Token User):

 {"usertoken":"<TOKEN USER>"}

Modifica Utente (Paziente)

Questo metodo aggiorna un utente su Visitami.

Public Function APIGEN_UpdUser(ByVal usertoken As String, ByVal nome As String, ByVal cognome As String, ByVal phone As String, ByRef lErr As String) As String
  • usertoken = Token User
  • nome = Nome del Paziente
  • cognome = Cognome del Paziente
  • phone = Telefono del Paziente
  • lErr (out) = parametro in uscita valorizzato con l'eventuale errore se il metodo ritorna emtpystring

La chiamata produrrà un JSON che indica il successo dell'operazione:

 {"status":"success","type":""}
  • status = success, o la chiamata non ha restituito nulla

Eliminazione Utente (Paziente) o eliminazione Legame

Questo metodo serve per eliminare il paziente su Visitami o il relativo Legame con l'applicazione richiedente

Public Function APIGEN_DeleteUser(ByVal usertoken As String, ByRef lErr As String) As String
  • usertoken = Token User
  • lErr (out) = parametro in uscita valorizzato con l'eventuale errore se il metodo ritorna emtpystring

La chiamata produrrà un JSON che indica il successo dell'operazione:

 {"status":"success","type":"<TIPO ELIMINAZIONE>"}
  • status = success, o la chiamata non ha restituito nulla
  • type = può assumere: TOTALE/PARZIALE asseconda della marcatura dell'utente su Visitami.

Controllo Utente (Paziente)

Questo metodo server per controllare la validità del legame tra applicazione richiedente e Visitami.

Public Function APIGEN_CheckUser(ByVal usertoken As String, ByRef lErr As String) As String
  • usertoken = Token User
  • lErr (out) = parametro in uscita valorizzato con l'eventuale errore se il metodo ritorna emtpystring

La chiamata produrrà un JSON che indica il successo dell'operazione:

 {"status":"success","type":""}
  • status = success, o la chiamata non ha restituito nulla

Creazione Token di Prenotazione (Semplice)

Per invocare il Widget Dinamico è necessario possedere il Token Professionista ed il Token Prenotazione. Per ottenere il Token Prenotazione è necessario invocare il seguente metodo:

Public Function APIGEN_CreaTokenPrenoSimple(ByVal usertoken As String, ByVal idprest As Integer, ByVal codCitta As String, ByRef lErr As String) As String
  • usertoken = Token User
  • idprest = Id della prestazione
  • codCitta = Codice Univoco che identifica la città (passare stringa vuota per prenotazioni di videovisite)
  • lErr (out) = parametro in uscita valorizzato con l'eventuale errore se il metodo ritorna emtpystring

Il metodo restituisce direttamente un JSON di questo tipo:

{"TokenPreno":"<TOKEN PRENO>"}
  • TokenPreno = token di prenotazione, altrimenti il metodo non ha restituito nulla

Creazione Token di Prenotazione

Per invocare il Widget Dinamico è necessario possedere il Token Professionista ed il Token Prenotazione. Per ottenere il Token Prenotazione è possibile invocare il seguente metodo a cui passare le coordinate GPS ed il raggio.

Public Function APIGEN_CreaTokenPreno(ByVal usertoken As String, ByVal idprest As Integer, ByVal lat As String, ByVal lng As String, ByVal km As Integer, ByRef lErr As String) As String
  • usertoken = Token User
  • idprest = Id della prestazione
  • lat = stringa della latitudine (usare ".", es. "45.12312312")
  • lng = stringa della longitudine (usare ".", es. "9.12312312")
  • km = raggio di ricerca in Km
  • lErr (out) = parametro in uscita valorizzato con l'eventuale errore se il metodo ritorna emtpystring

Il metodo restituisce direttamente un JSON di questo tipo:

{"TokenPreno":"<TOKEN PRENO>"}
  • TokenPreno = token di prenotazione, altrimenti il metodo non ha restituito nulla

vedere esempio nel file token-preno.php

Gestione Prenotazioni User

E' disponibile un metodo che restituisce le prenotazioni dell'utente Paziente

Public Function APIGEN_GetPrenoUser(ByVal usertoken As String, ByRef lErr As String) As String
  • usertoken = Token User
  • lErr (out) = parametro in uscita valorizzato con l'eventuale errore se il metodo ritorna emtpystring

Il metodo restituisce un JSON tipo questo:

[{"idPreno":"P03092","idPrenoVisitami":12434,"single_prenotoken":"TXRCdHoycklSUVl3V1ZrTDhCcFp3VHRmWlIwd2dEcDY2ekhOdDNrMEhDZz0=","Professionista":"Dr. Francesco Bianchi","IdProfessionista":1117,"UrlImmagine":"https://dev.visitamiapp.com/getpic?PicID=!PROF@1117\\med\u0026Token=TXRCdHoycklSUVl3V1ZrTDhCcFp3UVVWaDg1c0szcGR2b2YyQjFVd1M5ND0=\u0026MyToken=TXRCdHoycklSUVl3V1ZrTDhCcFp3UVVWaDg1c0szcGR2b2YyQjFVd1M5ND0=","TokenProf":"TXRCdHoycklSUVl3V1ZrTDhCcFp3UVVWaDg1c0szcGR2b2YyQjFVd1M5ND0=","Specializzazione":"medico generico","Stato":"APPUNTAMENTO CONFERMATO","idStato":1,"OkCancellazione":false,"IdPrestazione":184,"NomePrestazione":"Visita Medica Generica","Data":"Domenica 24 Marzo","Ora":"13:15","Indirizzo":"Man, Via Giuseppe Verdi, 2/A, Milano, 20121 MI cit: verde","Tariffa":"100-200€","TariffaScontata":"","Sconto":"","ScontoD":0}, ... ]
  • idPreno = Codice della Prenotazione
  • idPrenoVisitami = Id interno prenotazione in Visitami
  • single_prenotoken = Token Prenotazione Singola da usare nella APIGEN_DeletePrenoUser
  • Professionista = Nome del professionista
  • IdProfessionista = Id univoco del professionista in Visitami
  • UrlImmagine = URL dell'immagine profilo del professionista
  • TokenProf = Token Professionista/Struttura
  • Specializzazione = Nome della specializzazione principale
  • Stato = Stato dell'Appuntamento
  • idStato = Codice stato interno a Visitami
  • OkCancellazione = Indica se è possibile disdire l'appuntamento
  • IdPrestazione = Id univoco della prestazione in Visitami
  • NomePrestazione = Nome della Prestazione
  • Data = Data dell'appuntamento
  • Ora = Ora dell'appuntamento
  • Indirizzo = Luogo dell'appuntamento
  • Tariffa = Tariffa prevista per la prestazione. Le tariffe sono espresse in € e possono essere variabili (per es. 50-70€)
  • TariffaScontata = Se presente uno sconto, rappresenta il prezzo che pagherà il paziente
  • Sconto = Label che rappresenta lo Sconto % eventualmente applicato
  • ScontoD = Valore decimale dello sconto applicato. 0=nessuno sconto
  • isVideo = Se true è una videocall
  • LinkVideo = se è una videocall contiene l'url della videocall

Cancellazione di una Prenotazione User

E' disponibile un metodo per cancellare una prenotazione effettuata:

 Public Function APIGEN_DeletePrenoUser(ByVal usertoken As String, ByVal single_prenotoken As String, ByRef lErr As String) As String
  • usertoken = Token User
  • single_prenotoken = Token Prenotazione Singola
  • lErr (out) = parametro in uscita valorizzato con l'eventuale errore se il metodo ritorna emtpystring

Il metodo restituisce un JSON tipo questo:

 {"status":"success","type":""}
  • status = success, o la chiamata non ha restituito nulla

Info Professionista

Questo metodo serve a ricevere informazioni base sul professionista, come albo, specialità, prfessione etc.

Public Function APIGEN_GetInfoProf(ByVal email As String, ByRef lErr As String) As String
  • email = email del professionista
  • lErr (out) = parametro in uscita valorizzato con l'eventuale errore se il metodo ritorna emtpystring

La chiamata produrrà un JSON come quello seguente:

 {"spec1":47,"prof":43,"spec2":48,"spec3":65,"spec4":1,"albo":"MI-1222XX","pic":"http://..."}
  • spec1 = id specialità principale
  • prof = id professione legata alla specialità principale
  • spec2 = id specialità 2 (o 0 se non ha altra specialità)
  • spec3 = id specialità 3 (o 0 se non ha altra specialità)
  • spec4 = id specialità 4 (o 0 se non ha altra specialità)
  • pic = URL immagine profilo

Widget Dinamico di Prenotazione (Javascript)

Per effettuare le prenotazioni è necessario incollare il seguente codice nella pagina che ospiterà il Widget Dinamico di Prenotazione Visitami. Questo widget mostrerà il dettaglio del professionista individuato da Token Prof, la sua foto profilo, il suo profilo, le prestazioni disponibili nell'area di ricerca e gli orari di prenotazione. Il widget completerà la prenotazione basandosi sulle informazioni contenute dal Token Prenotazione. Questi due token verranno passati nell'url del Widget. Il Widget da solo carica componenti quali jQuery o stili associati. E' modificabile in termini di colori (maggiori info scrivendo a [email protected]).

<!-- INIZIO CODICE WIDGET VISITAMIHTML5/ALTRO --><script type="text/javascript" src="https://www.visitamiapp.com/widget?token=<TOKEN PROF>&TokenPreno=<TOKEN PRENO>&idluogo=0&nojquery=auto&qfit=1&urlback=&maincolor=f07f22&cpayload=&ShowNomePrest=1&fbw=&fbmleft=&showdispora=0&idesterno=&bfontsize=&nomobile=0&showinfo=0&nopayload=1&fbscope=1&no_orari_ext=0"></script><div id="VISITAMI_CONTAINER_INFO" style="background-color:white;position:relative;width:396px;height:262px;max-width:99%;font-size:0.9em;line-height:1.2em"></div><div style="position:relative;width:396px;height:446px;max-width:99%;font-size:0.9em"><div id="VISITAMI_CONTAINER" style="position:absolute;width:100%;height:100%;top:0;left:0;"></div><div style="font-size: 0.9em; width: 100%; height: 18px; line-height: 18px; position: absolute; bottom: 0px; left: 0px; text-align: right;">servizio gratuito powered by <span style="color:#f07f22"><b><a href="https://www.visitamiapp.com/" target="_blank" style="color:#f07f22">Visitami</a></b></span></div></div><!-- FINE CODICE WIDGET VISITAMI -->

Fissare un appuntamento in Videovisita

Per fissare un appuntamento in videovisita, è possibile utilizzare anche un endpoint rest

<URL>/mdf/videovisita
<i> Sviluppo </i>
https://demo.visitamiapp.com/ 

<i> Produzione </i>
https://www.visitamiapp.com/ 

A questo endpoint vanno passati:

  • data = in formato YYYYMMDD rappresenta la data dell'appuntamento
  • ora = in formato HHmm rappresenta l'ora dell'appuntamento
  • email_doc = email del medico a cui sarà inviato il link per collegamento a videovisita
  • nome_doc = nome del medico
  • durata_p = durata in minuti che viene poi rappresentata come slot da 5'
  • email_pz = email del paziente (non può coincidere con quella del medico)
  • nome_pz = nome del paziente
  • sesso_pz = M/F
  • status = 0 nuova prenotazione, 1 modifica, 2 eliminazione
  • sendemail = 1 se il sistema deve inviare automaticamente le email di notifica, 0 se invece non si vuole che il sistema mandi notifiche
  • roomid = vuoto nel caso di creazione (status 0), con il roomid da modificare o eliminare nel caso di status 1 o 2

L'api è protetta da chiamata attraverso un'autenticazione basic plain text da passare nell'header. Per completare l'autenticazione all'endpoint è necessario quindi essere in possesso di un client-id e un client-secret forniti da Paginemediche.

la chiamata produrrà un json come quello seguente:

{"status": 200, "error": "", "results": 1, "timestamp": "2021-11-22 16:33:15", "data": {"idRoom": "MGZLbVJyRDl0Qnc2ck1sTnUzUzFoUT09", "linkDoc": 
"https://dev.visitamiapp.com/videocall/MGZLbVJyRDl0Qnc2ck1sTnUzUzFoUT09/0/TXRCdHoycklSUVl3V1ZrTDhCcFp3ZUt0dy9qTnNBQWZkZndJMlJjSXcrTmFGRFJkT255aFN1a05vZEs5Q0dNUA==/owner",
"linkPz":
"https://dev.visitamiapp.com/videocall/MGZLbVJyRDl0Qnc2ck1sTnUzUzFoUT09/0/TXRCdHoycklSUVl3V1ZrTDhCcFp3Yis2VHpDTVhTYUhSY1FLT1JyVjlUSkNYU1ByTWJ6dEhFa0ZXcVNUQVRWdg==/guest"} }

in cui (a parte lo stato della chiamata e l'eventuale errore ricevuto) sono presenti in data:

  • idRoom = id univoco della room creata che servirà nel caso di modifica/cancellazione
  • linkDoc = link per connessione medico (il medico la riceverà anche in email nel caso si sia scelto opzione sendmail=1)
  • linkPz = link per connessione paziente (il paziente la riceverà anche in email nel caso si sia scelto opzione sendmail=1)

E' disponibile una collection postman per provare le chiamate al seguente indirizzo:

https://www.getpostman.com/collections/bccf45e2fd4d5d61d741   

About

Visitami API

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published