Virtual Meeting

[API Web vers. 2] Di seguito vengono riportate le indicazioni per poter "manipolare" gli utenti/corsisti tramite API_KEY.
La propria API_KEY è individuabile alla sezione "Impostazioni" dell'Area Riservata accessibile agli utenti di tipo "Segreteria" di VM E-Learning. In caso di necessità o ulteriori informazioni utilizzare il nostro Servizio di Supporto

Ottenere la lista dei corsi:

ENDPOINT: https://www.formeeting.it/apiweb_v2/listofcourses.asp
METODO: POST

PARAMETRI OBBLIGATORI:
apikey=YOUR_API_KEY

ESEMPIO DI CHIAMATA:

<script type="text/javascript">
$(document).ready(function() {
  $("#pulsante").click(function(){
    var apikey = "{DBEBF4E7-EED5-4AB4-889A-4E4BEZX72C54}";
    $.post("https://www.formeeting.it/apiweb_v2/listofcourses.asp", { apikey: apikey }, function(msg){ $("#risultato").html(msg); });
    })})
	</script>

ESEMPIO DI RISPOSTA:

<output>
<Apikey>{DBEBF4E7-EED5-4AB4-889A-4E4BEZX72C54}</Apikey>
<Result>1</Result>
<ListaCorsi>
<Corso>
<Codice_corso>9346</Codice_corso>
<Titolo>Come creare immagini veloci con Canva</Titolo>
<DataCreazione>22/09/2019</DataCreazione>
<Stato>ON</Stato>
<ValidoDal>20/05/2018</ValidoDal>
<ValidoFino>31/12/2025</ValidoFino>
</Corso>
<Corso>
<Codice_corso>3267</Codice_corso>
<Titolo>Come Sviluppare e pubblicare una strategia di Facebook che Funzioni</Titolo>
<DataCreazione>30/01/2019</DataCreazione>
<Stato>ON</Stato>
<ValidoDal>20/05/2018</ValidoDal>
<ValidoFino>31/12/2025</ValidoFino>
</Corso>
</ListaCorsi>
</output>

Ottenere la lista degli utenti iscritti ad un corso:

ENDPOINT: https://www.formeeting.it/apiweb_v2/listofusers.asp
METODO: POST

PARAMETRI OBBLIGATORI:
apikey=YOUR_API_KEY
codice_corso=CODICE IDENTIFICATIVO DEL CORSO

ESEMPIO DI RISPOSTA:

<output>
<Apikey>{DBEBF4E7-EED5-4AB4-889A-4E4BEZX72C54}</Apikey>
<Result>1</Result>
<ListaUtenti>
<Utente>
<Codice_utente>699427</Codice_utente>
<UserID>mariorossi</UserID>
<Nome>Mario</Nome>
<Cognome>Rossi</Cognome>
<Email>mario.rossi@gmail.com</Email>
<Telefono>3456387265<Telefono/>
<Stato>1</Stato>
<TipoUtente>Allievo</TipoUtente>
<AttivoDal>05/04/2020</AttivoDal>
<AttivoFinoAl>31/12/2025</AttivoFinoAl>
</Utente>
<Utente>
<Codice_utente>710428</Codice_utente>
<UserID>carlobianchi89</UserID>
<Nome>Carlo</Nome>
<Cognome>Bianchi</Cognome>
<Email>cbianchi89@gmail.com</Email>
<Telefono>3516387223<Telefono/>
<Stato>1</Stato>
<TipoUtente>Tutor</TipoUtente>
<AttivoDal>30/04/2020</AttivoDal>
<AttivoFinoAl>28/04/2030</AttivoFinoAl>
</Utente>
</ListaUtenti>
</output>

Ottenere la lista degli utenti che hanno terminato un corso (in progress...):

ENDPOINT: https://www.formeeting.it/apiweb_v2/listofendusers.asp
METODO: POST

PARAMETRI OBBLIGATORI:
apikey=YOUR_API_KEY
codice_corso=CODICE IDENTIFICATIVO DEL CORSO

ESEMPIO DI RISPOSTA:

<output>
<Apikey>{DBEBF4E7-EED5-4AB4-889A-4E4BEZX72C54}</Apikey>
<Result>1</Result>
<ListaUtenti>
<Utente>
<Codice_utente>699427</Codice_utente>
<UserID>mariorossi</UserID>
<Nome>Mario</Nome>
<Cognome>Rossi</Cognome>
<Email>mario.rossi@gmail.com</Email>
<Telefono>3456387265<Telefono/>
<Stato>1</Stato>
<TipoUtente>Allievo</TipoUtente>
<AttivoDal>05/04/2020</AttivoDal>
<AttivoFinoAl>31/12/2025</AttivoFinoAl>
</Utente>
<Utente>
<Codice_utente>710428</Codice_utente>
<UserID>carlobianchi89</UserID>
<Nome>Carlo</Nome>
<Cognome>Bianchi</Cognome>
<Email>cbianchi89@gmail.com</Email>
<Telefono>3516387223<Telefono/>
<Stato>1</Stato>
<TipoUtente>Tutor</TipoUtente>
<AttivoDal>30/04/2020</AttivoDal>
<AttivoFinoAl>28/04/2030</AttivoFinoAl>
</Utente>
</ListaUtenti>
</output>

Aggiungere/Creare un nuovo corso/evento (in progress...):

ENDPOINT: https://www.formeeting.it/apiweb_v2/addevent.asp
METODO: POST

PARAMETRI OBBLIGATORI:
apikey=YOUR_API_KEY
titolo_evento=TITOLO DEL CORSO/EVENTO
tipo_evento=TIPOLOGIA DI EVENTO (0 ONLINE - 1 RESIDENZIALE)
data_inizio=DATA DI INIZIO
data_fine=DATA DI FINE

ESEMPIO DI RISPOSTA:

<output>
<Apikey>{DBEBF4E7-EED5-4AB4-889A-4E4BEZX72C54}</Apikey>
<Result>1</Result>
<Codice_corso>9346</Codice_corso>
</output>

Ottenere la lista dei corsi ai quali è iscritto un utente:

ENDPOINT: https://www.formeeting.it/apiweb_v2/listofcoursesforuser.asp
METODO: POST

PARAMETRI OBBLIGATORI:
userid=USERID UTENTE
pwd=PASSWORD UTENTE

ESEMPIO DI RISPOSTA:

<output>
<Apikey>{DBEBF4E7-EED5-4AB4-889A-4E4BEZX72C54}</Apikey>
<Result>1</Result>
<UserId>carlobianchi</UserId>
<ListaCorsi>
<Corso>
<Ente>Virtual+Meeting</Ente>
<Codice_corso>2673</Codice_corso>
<Titolo>PHOTOSHOP+CS6+AVANZATO</Titolo>
<Scadenza>31/12/2025</Scadenza>
<url>https://www.formeeting.it/fad/st_cambia_corso.asp?id=79234</url>
</Corso>
<Corso>
<Ente>Virtual+Meeting</Ente>
<Codice_corso>2670</Codice_corso>
<Titolo>MICROSOFT+OFFICE+365+LIVELLO+BASE</Titolo>
<Scadenza>15/10/2019</Scadenza>
<url>https://www.formeeting.it/fad/st_cambia_corso.asp?id=11879</url>
</Corso>
</ListaCorsi>
</output>

Aggiungere/Creare un nuovo utente:

ENDPOINT: https://www.formeeting.it/apiweb_v2/adduser.asp
METODO: POST

PARAMETRI OBBLIGATORI:
apikey=YOUR_API_KEY
codice_corso=CODICE IDENTIFICATIVO DEL CORSO
nome=NOME CORSISTA
cognome=COGNOME CORSISTA
mail=EMAIL CORSISTA

PARAMETRI FACOLTATIVI:
get_code=0 oppure 1 (se valore uguale a 1 vengono aggiunti alla risposta userid e password dell'utete creato)
stato=0 oppure 1 (se valore uguale a 0 l'utente viene impostato come disabilitato)
tel=TELEFONO
codfisc=CODICE FISCALE
piva=PARTITA IVA
indirizzo=INDIRIZZO
citta=CITTA'
cap=CAP
provincia=PROVINCIA
luogonascita=LUOGO DI NASCITA
datanascita=DATA DI NASCITA

ESEMPIO DI RISPOSTA:

<output>
<Apikey>{DBEBF4E7-EED5-4AB4-889A-4E4BEZX72C54}</Apikey>
<Result>1</Result>
<Codice_utente>615958</Codice_utente>
<UserId>Null</UserId>
<Pwd>Null</Pwd>
</output>

Modificare/aggiornare un utente:

ENDPOINT: https://www.formeeting.it/apiweb_v2/updateuser.asp
METODO: POST

PARAMETRI OBBLIGATORI:
apikey=YOUR_API_KEY
userid=USERID UTENTE
codice_utente=CODICE IDENTIFICATIVO UTENTE

PARAMETRI FACOLTATIVI:
nome=NOME
cognome=COGNOME
mail=EMAIL
stato=0 oppure 1
tel=TELEFONO
codfisc=CODICE FISCALE
piva=PARTITA IVA
indirizzo=INDIRIZZO
citta=CITTA'
cap=CAP
provincia=PROVINCIA
luogonascita=LUOGO DI NASCITA
datanascita=DATA DI NASCITA

ESEMPIO DI RISPOSTA:

<output>
<Apikey>{DBEBF4E7-EED5-4AB4-889A-4E4BEZX72C54}</Apikey>
<Result>1</Result>
<Codice_utente>641962</Codice_utente>
<UserId>carlobianchi89</UserId>
</output>

Inviare le credenziali di accesso ad un utente:

ENDPOINT: https://www.formeeting.it/apiweb_v2/sendcredentials.asp
METODO: POST

PARAMETRI OBBLIGATORI:
apikey=YOUR_API_KEY
userid=USERID UTENTE
codice_utente=CODICE IDENTIFICATIVO UTENTE

ESEMPIO DI RISPOSTA:

<output>
<Apikey>{DBEBF4E7-EED5-4AB4-889A-4E4BEBA79C24}</Apikey>
<Result>1</Result>
<Codice_utente>641962</Codice_utente>
<UserId>carlobianchi89</UserId>
</output>

Rimuovere un utente:

ENDPOINT: https://www.formeeting.it/apiweb_v2/deluser.asp
METODO: POST

PARAMETRI OBBLIGATORI:
apikey=YOUR_API_KEY
userid=USERID UTENTE
codice_utente=CODICE IDENTIFICATIVO UTENTE

ESEMPIO DI RISPOSTA:

<output>
<Apikey>{DBEBF4E7-EED5-4AB4-889A-4E4BEBA79C24}</Apikey>
<Result>1</Result>
<Codice_utente>641962</Codice_utente>
<UserId>carlobianchi89</UserId>
</output>

Funzionalità di Single Sign-On (SSO):
E' possibile eseguire una chiamata POST all'indirizzo di seguito indicato per poter loggare un utente alla piattaforma VM eLearning. Questa operazione risulta essere particolarmente utile qualora si intenda autenticare l'utente su una propria piattaforma/area riservata e contestualmente loggarlo anche su VM. Dopo l'autenticazione l'utente potra infatti, secondo le modalità da voi ritenute più opportune, accedere ai propri corsi online senza doversi nuovamente autenticare.

ENDPOINT: https://www.formeeting.it/apiweb_v2/sso.asp
METODO: POST

PARAMETRI OBBLIGATORI:
apikey=YOUR_API_KEY
userid=USERID UTENTE
pwd=PASSWORD UTENTE

LEGENDA OUTPUT:
RESULT: (0 in caso di esito negativo - 1 in caso di esito positivo)
CODE: (0: ApiKey errata - 1: dati mancanti - 2: dati errati - 3: utente inesistente - 4: cliente scaduto - 5: corso non attivo - 6: utente abilitato)
URL: pagina web verso cui reindirizzare l'utente per iniziare il corso/i

L'utente sarà pertanto loggato su VM se la risposta alla chiamata restituirà result=1 e code=6.

ESEMPIO DI RISPOSTA:

<output>
<Apikey>{DBEBF4E7-EED5-4AB4-889A-4E4BEBA79C24}</Apikey>
<Result>1</Result>
<Code>6</Code>
<UserId>carlobianchi89</UserId>
<url>https://www.formeeting.it/fad/st_home.asp?2fcat=0</url>
</output>

Nel caso abbiate necessità di ulteriori e differenti "modi" di integrazione con la piattaforma, il nostro Ufficio Tecnico è a vostra completa disposizione per analizzare qualsiasi richiesta!

E-Learning / Web API