Ao tentar realizar uma requisição de login na rota {{server}}/api/v2/workspace/login utilizando o Postman, você pode se deparar com os seguintes erros:
Erro 405 - "Not allowed"
Esse erro normalmente ocorre quando a requisição HTTP utiliza um método incorreto (ex: GET ao invés de POST). Verifique se você está utilizando o método POST, que é o exigido pela rota de login.
Erro 400 - "Incorrect e-mail or password or your account was not verified"
Esse erro indica que o login ou a key utilizados estão incorretos, ou que a conta ainda não foi verificada. Mesmo que você tenha certeza das credenciais, vale revisar alguns pontos importantes (listados abaixo).
Método HTTP Incorreto
A rota de login exige o uso do método POST. Verifique se o método da sua requisição está configurado corretamente,
Credenciais Incorretas
As variáveis login e key devem ser obtidas na página Ambiente de Desenvolvedor do BotCity Maestro.
Certifique-se de que esses dados foram copiados corretamente e estão sendo passados no corpo da requisição. Você pode conferir na documentação da BotCity
Conta Não Verificada
Verifique se a conta utilizada para login foi validada por e-mail. Caso não tenha feito isso, localize o e-mail de verificação enviada pela BotCity e conclua a ativação da conta.
Ambiente do Postman Mal Configurado
É altamente recomendável configurar corretamente o Environment no Postman, conforme o exemplo fornecido na documentação da BotCity.
Importe o Environment de Exemplo
Faça o download do arquivo de environment de exemplo disponível na documentação oficial.
Importe o arquivo no Postman e edite os valores conforme o seu workspace.
Exemplo de Variáveis no Environment
| VARIÁVEL | TIPO | DESCRIÇÃO |
|---|---|---|
server | default | URL base da API (Ex.: https://developers.botcity.dev) |
login | secret | Seu login do ambiente de desenvolvedor |
key | secret | Sua chave do ambiente de desenvolvedor |
token | default | Gerado pela rota de login |
organization | default | Gerado pela rota de login |
Importe a Collection de Exemplo
Baixe a collection de exemplos da API.
Importe no Postman e associe ao environment que você criou.
Com o environment corretamente configurado e a collection importada:
Execute a requisição Login - Workspace.
Os valores de token e organization serão automaticamente salvos no environment.
Esses valores serão utilizados automaticamente nos headers das próximas requisições.
Após a autenticação bem-sucedida, seu ambiente estará pronto para explorar as demais funcionalidades da API do BotCity.
Consulte a Documentação Completa
Acesse a documentação oficial da API BotCity para obter informações detalhadas sobre todas as rotas disponíveis e instruções adicionais.