# Web API

Web API è un framework che consente di compilare servizi HTTP per raggiungere un gran numero di client, compresi i browser e i dispositivi mobili.

### URL di base

L’URL di base è composto nel modo seguente:

<Protocollo>://<Nome dominio>:<Numero di porta>/api/v1

- Protocollo: HTTP (Versione 1.1)
- Per il nome del dominio utilizzare l'indirizzo IP del visualizzatore.

  Nota: se si usa il visualizzatore con la serie SP5000 Open Box (Windows 10 IoT Enterprise Model), serie IPC o PC/AT, si può usare anche il nome della macchina.

- Numero di porta: il numero di porta si può impostare nel software di modifica delle schermate. Configurazione delle impostazioni del server web

## Login

Immettere il nome utente e la password per giungere al token. Con l’utilizzo di Sicurezza, il token si usa per le autorizzazioni.

Nota: L'autenticazione basata su token è una tecnica di protezione per autenticare gli utenti che tentano di accedere a un server, a una rete o altro sistemi sicuri, utilizzando un token di sicurezza fornito dal server.

Panoramica

### Richiesta

Elemento | Valore
Metodo | POST
URL | <Base URL>/login
Parametri | N/A
Intestazione | Content-Type, Content-Length
Intestazione | Valore
Content-Type | application/json
Corpo | JSON
Campo | Tipo di dati | Note
username | stringa | Nome utente
password | stringa | Password
Esempio | POST http://192.168.1.100:8000/api/v1/login HTTP/1.1 Host: localhost:8082 Content-Type: application/json content-length: 44 { "username":"User1", "password":"Pass1" } Nota: il codice dell’esempio è scritto in Java.

### Risposta

Elemento | Valore
Codice di stato | Autenticazione riuscita, il visualizzatore invierà 200 (OK).
Codice | Nota
200 OK | Autenticazione riuscita
401 Unauthorized | Autenticazione non riuscita
Intestazione | Content-Type, Transfer-Encoding
Intestazione | Valore
Content-Type | application/json
Transfer-Encoding | Chunked
Corpo | JSON
Campo | Tipo di dati | Nota
token | stringa | Token autenticato
Esempio | 0 Nota: il codice dell’esempio è scritto in Java.