Crea un'app API

Un'app dà al tuo software l'accesso all'API di Softalon all'indirizzo https://api.softalon.com/v1. Ogni app ha un client ID e un client secret, che usa per ottenere token di accesso con OAuth 2.0.

Esistono due tipi di app:

Crea un'app del salone

1. 1

   Passaggio 1 di 5

   Apri App

   Vai in Impostazioni › Sviluppatori › App e fai clic su Crea app.

2. 2

   Passaggio 2 di 5

   Dai un nome all'app

   Inserisci un Nome app. Le persone vedono questo nome quando viene chiesto loro di autorizzare la tua app.

3. 3

   Passaggio 3 di 5

   Aggiungi gli ambiti

   In Ambiti, aggiungi uno alla volta ogni permesso di cui la tua app ha bisogno. La tua app può richiedere solo gli ambiti che aggiungi qui. Vedi l'elenco degli ambiti più sotto.

4. 4

   Passaggio 4 di 5

   Aggiungi gli URI di reindirizzamento

   In URI di reindirizzamento, aggiungi ogni URL completo che la tua app usa per ricevere le risposte OAuth, per esempio https://app.example.com/oauth/callback. La tua app può usare solo gli URI che aggiungi qui. Puoi saltare questo passaggio se la tua app comunica con l'API solo da un server.

5. 5

   Passaggio 5 di 5

   Crea l'app e salva il secret

   Fai clic su Crea app.

   Vedrai:

   Una finestra con le credenziali, con il tuo Client ID e il tuo Client Secret.

   Copiali entrambi e conservali subito in un posto sicuro.

Crea un'app dell'account

Vai in Account › App e fai clic su Registra app. I campi e il secret mostrato una sola volta funzionano come per un'app del salone.

Ambiti

Gli ambiti hanno la forma area:action.

Aggiungi solo gli ambiti di cui la tua app ha bisogno.

Ottenere i token

Le app supportano questi tipi di concessione OAuth 2.0:

• Client credentials, per l'accesso da server a server senza un utente.
• Authorization code, quando una persona accede e approva la tua app. Vedi Consenti a un'app di accedere al tuo account.
• Refresh token, per ottenere nuovi token di accesso senza chiedere di nuovo.

Quando la tua app richiede un token, invia il suo client ID e il suo secret con l'autenticazione HTTP Basic.

Modifica o elimina un'app

Apri il menu dell'app nella tabella:

• Aggiorna cambia il nome, gli ambiti o gli URI di reindirizzamento. Client ID e secret restano invariati.
• Elimina rimuove l'app e le sue credenziali. Qualsiasi sistema che le usa non può più ottenere token.