1. Resumo da Mudança
A Jacto está atualizando os endpoints de autenticação da plataforma EKOS da versão v1 para a versão v2. A nova versão incorpora mecanismos de segurança aprimorados que fortalecem a proteção do acesso às nossas APIs.
A alteração afeta exclusivamente o caminho (path) das URLs. Payloads, headers, métodos HTTP e formatos de token permanecem idênticos — portanto, a adaptação em seus sistemas é simples e rápida.
| Descrição | Endpoint Atual v1 | Novo Endpoint v2 |
|---|---|---|
| Autenticação Connect | POST /users/api/v1/auth | POST /users/api/v2/auth |
| Obter Token EKOS | GET /users/api/v1/me/ekos/token | GET /users/api/v2/me/ekos/token |
Base URL: https://prd-api-connect-elb.jacto.com
2. Impacto da Não Atualização
O que acontece se eu não atualizar?
- Erros de autenticação:
HTTP 401 UnauthorizedouHTTP 404 Not Found - Impossibilidade de obter novos tokens de acesso
- Perda total de acesso às APIs do EKOS
- Interrupção de processos automatizados, scripts, jobs e integrações de sistemas
A atualização é obrigatória para todos os clientes que realizam integrações programáticas com a plataforma EKOS. Durante a janela de transição (15 a 22/07) as duas versões operam em paralelo; após 22/07 às 19h, apenas a v2 será aceita.
✅ Clientes que acessam as APIs do EKOS via API Key não serão impactados neste momento. Essa mudança afeta exclusivamente o fluxo de autenticação por e-mail e senha (Token Connect).
3. Passo a Passo da Autenticação (v2)
O fluxo permanece em três etapas. Apenas as URLs mudam:
Autenticação Connect — obter Token Connect
Realize uma requisição POST com seu e-mail e senha EKOS para receber o Token Connect.
POSThttps://prd-api-connect-elb.jacto.com/users/api/v2/authRequisição:
curl --location --request POST \
'https://prd-api-connect-elb.jacto.com/users/api/v2/auth' \
--header 'Content-Type: application/json' \
--data-raw '{
"email": "usuario.ekos@suaempresa.com.br",
"password": "sua-senha"
}'Retorno:
Obter Token EKOS
Utilize o Token Connect obtido no Passo 1 para uma requisição GET e receber o Token EKOS.
GEThttps://prd-api-connect-elb.jacto.com/users/api/v2/me/ekos/tokenRequisição:
curl --location --request GET \ 'https://prd-api-connect-elb.jacto.com/users/api/v2/me/ekos/token' \ --header 'Authorization: Bearer eyJhbGciOiJQUzUxMiJ9.****************************7onGA'
Retorno:
Utilizar o Token EKOS nas APIs
O Token EKOS obtido no Passo 2 deve ser utilizado no header Authorization de todas as chamadas subsequentes às APIs do EKOS. Consulte também a página de Autenticação.
4. Referência Rápida — Antes e Depois
# Passo 1
curl --request POST \
'https://prd-api-connect-elb.jacto.com/users/api/v1/auth' \
--header 'Content-Type: application/json' \
--data-raw '{...}'
# Passo 2
curl --request GET \
'https://prd-api-connect-elb.jacto.com/users/api/v1/me/ekos/token' \
--header 'Authorization: Bearer <TOKEN>'# Passo 1
curl --request POST \
'https://prd-api-connect-elb.jacto.com/users/api/v2/auth' \
--header 'Content-Type: application/json' \
--data-raw '{...}'
# Passo 2
curl --request GET \
'https://prd-api-connect-elb.jacto.com/users/api/v2/me/ekos/token' \
--header 'Authorization: Bearer <TOKEN>'5. Checklist de Migração
Realize os itens abaixo antes de 22/07/2026:
- Identificar todos os sistemas e integrações que utilizam os endpoints v1
- Substituir
/v1/por/v2/nas configurações de URL - Validar que os tokens retornados funcionam nas demais chamadas de API
- Atualizar scripts, jobs e processos automatizados
- Confirmar que a migração foi concluída antes de 22/07/2026 às 19h
6. Dúvidas e Suporte
Em caso de dúvidas ou dificuldades durante a migração, entre em contato com o suporte técnico da Jacto:
- E-mail de suporte: alexandre.bonacasata@jacto.com.br – Alexandre Bonacasata (Time EKOS)
- Documentação das APIs: https://ekos-docs.jacto.com/