Skip to main content

Autenticação na API Joviplanet

Atenção: Para obter seu usuário e senha de acesso à API, é necessário realizar um cadastro prévio em joviplanet.com e contratar um plano que inclua a liberação de uso da API. Após a contratação, suas credenciais serão disponibilizadas pela equipe Joviplanet.

Para acessar os recursos protegidos da API Joviplanet, você precisa realizar a autenticação utilizando o endpoint de login. O processo é simples e seguro, garantindo que apenas usuários autorizados possam utilizar os serviços.

Endpoint de Autenticação​

POST https://api.joviplanet.com/api/usuarios/login

Corpo da Requisição​

Envie um JSON com seu e-mail e senha cadastrados:

{
  "usuario": "seu-email@dominio.com",
  "senha": "suasupersecreta"
}

Exemplo de Requisição (cURL)​

curl -X POST "https://api.joviplanet.com/api/usuarios/login" \
  -H "accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "usuario": "seu-email@dominio.com",
    "senha": "suasupersecreta"
  }'

Resposta Esperada​

Se as credenciais estiverem corretas, você receberá um JSON contendo uma mensagem de sucesso e um token JWT:

{
  "mensagem": "Autenticado com sucesso",
  "token": "<seu-token-jwt>",
  "status": 1
}

O token JWT deve ser utilizado no cabeçalho Authorization das próximas requisições para acessar os endpoints protegidos da API.

Utilizando o Token​

Inclua o token JWT no cabeçalho das requisições:

Authorization: Bearer <seu-token-jwt>

Observações​

  • Nunca compartilhe seu token JWT publicamente.
  • O token JWT tem tempo de expiração de 1 hora. Após esse período, será necessário realizar um novo login para obter um token válido.
  • Em caso de dúvidas, consulte nossa equipe de suporte ou a documentação completa da API Joviplanet.

Pronto! Agora você já pode consumir os serviços protegidos da nossa API de forma segura.