Riferimento API IBM MaaS360 per i servizi Web

MaaS360® consente agli amministratori di accedere all'API dei servizi Web dall'interfaccia utente IBM® MaaS360 Portal. Contattare l'assistenza IBM per abilitare questa funzione per il proprio account MaaS360.

Il riferimento API per i servizi Web include dettagli quali note di implementazione, attributi obbligatori per eseguire l'API, dettagli di controllo accessi, classi di risposta con esempi di modelli e dettagli di parametro.

Diritti di accesso facilitato API dei servizi Web

MaaS360 include due tipi di diritti di accessibilità per accedere all'API dei servizi Web dal portale IBM MaaS360. Assegnare i diritti di accessibilità API dei servizi Web appropriati agli account amministratore con il ruolo di amministratore del servizio.

  • Accesso in lettura: L'amministratore può visualizzare la documentazione API del servizio Web nel portale IBM MaaS360. Agli account BU (Business Administrator) viene fornito l'accesso in lettura.
  • Accesso dell'amministratore: L'amministratore può visualizzare ed esaminare la documentazione dell'API del servizio Web nel portale IBM MaaS360. Agli account amministratore del cliente viene fornito l'accesso di amministratore.

A seconda del tipo di diritti di accesso assegnati a un amministratore, il livello di accessibilità dell'API del servizio Web per un account amministratore varia.

Disponibilità di servizi Web API dal portale IBM MaaS360

Gli amministratori con i ruoli di accessibilità appropriati possono accedere all'API dei servizi Web dal portale IBM MaaS360. Andare a Setup > Web Services API e fare clic su Documentazione per visualizzare o eseguire l'API dei servizi Web dal portale.

Un account amministratore con accesso admin può usare l'opzione Provalo per eseguire l'API del servizio Web.

Nota: l'API dei servizi Web MaaS360 supporta TLS versione 1.1 e successive.

Fasi di esecuzione dei servizi Web API dal portale IBM MaaS360

  1. Da Setup > Web Services API, fare clic su Documentation.
  2. Vai all'API Authentication , immetti l' ID di fatturazione del cliente e i parametri body .
  3. Fai clic su Provalo per creare un token di autenticazione.
    Nota: copiare il token di autenticazione generato nel corpo della risposta per provare qualsiasi API dei servizi Web MaaS360 . Dopo che hai generato il token, il token è valido per 60 minuti.
  4. Accedere a una qualsiasi API dei servizi Web di MaaS360 nel portale IBM MaaS360 e fornire i seguenti dettagli:
    • Tutti i parametri obbligatori di cui hai bisogno per provare l'API come l'ID di fatturazione.
    • Il token di autorizzazione che hai generato nel passo 3.
      Nota: il valore del token di autenticazione deve essere immesso tra virgolette e utilizzare il prefisso MaaS token=. Ad esempio, MaaS token="xxxxxx".
  5. Fai clic su Provalo per provare l'API dei servizi Web. Per l'API dei servizi Web vengono visualizzati l' URL della richiesta, il corpo della risposta, il codice della risposta e le intestazioni della risposta.
    Nota: il tipo di contenuto della risposta è application/XML per impostazione predefinita. Scegliere application/json se il tipo di contenuto della risposta deve essere nel formato JSON.