Autenticação
Todos os endpoints de integração exigem um token de API gerado no IRIS Cloud.
Envie um token Bearer#
Inclua o token no cabeçalho Authorization de cada requisição:
Authorization: Bearer YOUR_API_TOKENUse o token de API da conta de usuário. Sua senha do IRIS Cloud e a sessão de login do navegador não são tokens de API.
O acesso pertence à sua organização#
O token está associado à organização em que foi criado. A API verifica o token e o acesso à organização antes de retornar dados. Conhecer o ID de outra máquina não concede acesso a ela.
As operações de integração documentadas consultam dados. Elas não alteram configurações de máquinas nem criam lotes de produção.
Autentique-se na referência da API#
- Abra a referência da API e confirme o ambiente.
- Selecione Authorize.
- Cole apenas seu token. O Swagger adiciona o prefixo
Bearer. - Escolha um endpoint, selecione Try it out, preencha os parâmetros e selecione Execute.
- Use Logout no diálogo de autorização ao terminar.
Mantenha os tokens no backend da integração#
Armazene os tokens em um gerenciador de segredos ou em variáveis de ambiente protegidas. Não os inclua em código público do navegador, em repositórios ou em URLs.
Se um token for perdido ou exposto, revogue-o no IRIS Cloud e atualize a integração com um novo token. Consulte erros de autenticação para tokens expirados, revogados ou inválidos.