Referencia de API de IBM MaaS360 para servicios web

MaaS360® permite a los administradores acceder a la API de servicios web desde la IBM® MaaS360 interfaz de usuario. Póngase en contacto con IBM para habilitar esta función para su cuenta MaaS360.

La referencia de API para los servicios web incluye detalles como notas de implementación, atributos obligatorios para ejecutar la API, detalles de control de acceso, clases de respuesta con ejemplos de modelos y detalles de parámetro.

Derechos de accesibilidad de la API de servicios web

MaaS360 incluye dos tipos de derechos de accesibilidad para acceder a la API de servicios web desde el IBM MaaS360. Asigne los derechos de accesibilidad de la API de servicios web adecuados a las cuentas de administrador con el rol de administración de servicios.

  • Acceso de lectura: El administrador puede ver la documentación de la API del servicio web en el IBM MaaS360. Las cuentas de administrador empresarial (BU) se proporcionan con acceso de lectura.
  • Acceso de administrador: El administrador puede ver y probar la documentación de la API del servicio web en el IBM MaaS360. Las cuentas del administrador de clientes se proporcionan con acceso de administrador.

Dependiendo del tipo de derechos de acceso se asigna un administrador, el nivel de accesibilidad de la API de servicio web para la cuenta de administrador varía.

Disponibilidad de la API de servicios web desde el IBM MaaS360

Los administradores con los roles de accesibilidad adecuados pueden acceder a la API de servicios web desde el IBM MaaS360. Vaya a Configuración > API de servicios web y, a continuación, pulse Documentación para ver o ejecutar la API de servicios web desde el portal.

Una cuenta de administrador con acceso de administrador puede utilizar la opción Prúebelo para ejecutar la API de servicio web.

Nota: La API de servicios web de MaaS360 admite TLS versión 1.1 y posteriores.

Pasos de ejecución de la API de servicios web desde el IBM MaaS360

  1. En Configuración > API de servicios web, pulse Documentación.
  2. Vaya a la API de Autenticación, entre el ID de facturación del cliente y los parámetros delcuerpo.
  3. Haga clic en Pruébelo para generar un token de autenticación.
    Nota: Copie la señal de autenticación generada en el cuerpo de respuesta para probar cualquier API de servicios web de MaaS360 . Después de generar el token, el token es válido durante 60 minutos.
  4. Vaya a cualquier MaaS360 API de servicios web en el IBM MaaS360 Portal, y proporcione los siguientes detalles:
    • Todos los parámetros obligatorios que necesita para probar la API como, por ejemplo, el ID de facturación.
    • El token de autorización que ha generado en el paso 3.
      Nota: El valor de token de autenticación debe escribirse entre comillas y utilizar el prefijo MaaS token=. Por ejemplo, MaaS token="xxxxxx".
  5. Haga clic enPruébelo para probar la API de servicio web. Se visualizan el URL de solicitud, el cuerpo de respuesta, el código de respuesta y las cabeceras de respuesta para la API de servicios web.
    Nota: El tipo de contenido de respuesta es application/XML de forma predeterminada. Elija application/json si el tipo de contenido de respuesta debe estar en formato JSON.