IBM MaaS360 API de referência para serviços da Web

O MaaS360® permite que os administradores acessem a API de serviços da Web a partir da interface de usuário do IBM® MaaS360 Portal. Entre em contato com o IBM para ativar esse recurso em sua MaaS360.

A referência de API para serviços da web inclui detalhes, como notas de implementação, atributos obrigatórios para executar a API, detalhes de controle de acesso, classes de resposta com exemplos de modelo e detalhes de parâmetros.

Direitos de acessibilidade de API de serviços da

O MaaS360 inclui dois tipos de direitos de acessibilidade para acessar a API de serviços da Web a partir do IBM MaaS360 Portal. Designe os direitos de acessibilidade da API de serviços da web apropriados às contas de administrador com a função de administrador de serviço.

  • Acesso de leitura: O administrador pode visualizar a documentação da API do serviço da Web no IBM MaaS360 Portal. As contas de administrador de negócios (BU) são fornecidas com acesso de leitura.
  • Acesso de administrador: O administrador pode visualizar e experimentar a documentação da API do serviço da Web no IBM MaaS360 Portal. As contas de administrador no cliente são fornecidas com acesso de administrador.

Dependendo do tipo de direitos de acesso aos quais um administrador é designado, o nível de acessibilidade da API de serviço da web para uma conta de administrador varia.

Disponibilidade da API de serviços da Web no IBM MaaS360

Os administradores com as funções de acessibilidade apropriadas podem acessar a API de serviços da Web a partir do IBM MaaS360 Portal. Acesse Configuração > API de Serviços Web e depois clique em Documentação para visualizar ou executar a API de serviços web a partir do portal.

Uma conta de administrador com acesso de administrador pode usar a opção Experimentar para executar a API de serviço da web.

Nota: a API de serviços da web do MaaS360 suporta o TLS versão 1.1 e mais recente.

Etapas de execução da API de serviços da Web a partir do IBM MaaS360

  1. A partir de Configuração > API de Serviços Web, clique em Documentação.
  2. Acesse API de autenticação, insira os parâmetros billing ID e body do cliente.
  3. Clique em Experimente para gerar um token de autenticação.
    Nota: Copie o token de autenticação gerado no corpo de resposta para experimentar qualquer API de serviços web do MaaS360 . Depois de gerar o token, ele é válido por 60 minutos.
  4. Acesse qualquer API de MaaS360 serviços da Web no IBM MaaS360 e forneça os seguintes detalhes:
    • Todos os parâmetros obrigatórios que você precisa para experimentar a API, como billing ID.
    • O token de autorização gerado na etapa 3.
      Nota: o valor do token de autenticação deve ser inserido entre aspas e usar o prefixo MaaS token=. Por exemplo, MaaS token="xxxxxx".
  5. Clique em Experimente para testar a API de serviço da web. A URL de solicitação, o corpo de resposta, o código de resposta e os cabeçalhos de resposta são exibidos para a API de serviços da web.
    Nota: o tipo de conteúdo de resposta é application/XML por padrão. Escolha application/json se o tipo de conteúdo de resposta tiver que estar no formato JSON.