Autenticação

Todas as solicitações às API's devem ser autenticadas usando os métodos descritos nas diretrizes de autenticação de solicitações a baixo. As solicitações que falham na autenticação geralmente passam um código HTTP 401 e um erro descrevendo o motivo da rejeição.

Se você tiver uma chave de API, também poderá testar as chamadas de API na API na documentação interativa.

Migração de autenticação — v1 → v2

• 🟢 v2 disponível a partir de 15/07/2026 às 20h (horário de Brasília)
• ⚠️ v1 desativada em 22/07/2026 às 19h (horário de Brasília)

Durante esse período as duas versões funcionam em paralelo. Após a desativação, apenas a v2 será aceita. Detalhes no Aviso de Migração de Autenticação (v1 → v2).

Endpoints

Descrição	Endpoint v1 (até 22/07/2026)	Endpoint v2 (atual)
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

1. Autenticação Connect

O primeiro passo é informar o usuário e senha EKOS na requisição do tipo "POST", para obter o TOKEN CONNECT no retorno.

REQUISIÇÃO DO TIPO POST

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@email.com.br",
"password": "sua-senha"
}'

RETORNO

STATUS  | OK (200)

PAYLOAD | eyJhbGciOiJQUzUxMiJ9.**************\*\*\*\***************7onGA

2. Obter TOKEN

O segundo passo é utilizar o TOKEN adquirido no passo 1. na requisição do tipo "GET", para obter o TOKEN EKOS no retorno.

REQUISIÇÃO DO TIPO GET UTILIZANDO O TOKEN

curl --location --request GET 'https://prd-api-connect-elb.jacto.com/users/api/v2/me/ekos/token' \

--header 'Authorization: Bearer eyJhbGciOiJQUzUxMiJ9.****************\*****************7onGA'

RETORNO

STATUS  | OK (200)

PAYLOAD | eyJhbGciOiJQUzUxMiJ9.****************\*****************7onGA

3. Utilizar TOKEN

O terceiro passo é utilizar o TOKEN na documentação da API Interativa EKOS.

caution

O TOKEN expira em 7 dias.

Endpoints v1 — válidos até 22/07/2026 às 19h (descontinuados)

atenção

Os endpoints abaixo continuam funcionando somente até 22/07/2026 às 19h e serão desativados após essa data. Use-os apenas como referência durante a migração — o fluxo recomendado é o v2 descrito acima.

1. Autenticação Connect (v1)

REQUISIÇÃO DO TIPO POST (v1)

curl --location --request POST 'https://prd-api-connect-elb.jacto.com/users/api/v1/auth' \

--header 'Content-Type: application/json' \

--data-raw
'{
"email": "usuario.ekos@email.com.br",
"password": "sua-senha"
}'

2. Obter TOKEN (v1)

REQUISIÇÃO DO TIPO GET UTILIZANDO O TOKEN (v1)

curl --location --request GET 'https://prd-api-connect-elb.jacto.com/users/api/v1/me/ekos/token' \

--header 'Authorization: Bearer eyJhbGciOiJQUzUxMiJ9.****************\*****************7onGA'