Autenticar cliente

Rota: POST /api/v1/auth · Headers: nenhum token (é a rota que gera o Client Token) É a primeira chamada de qualquer integração. Ela recebe as chaves brutas enviadas por infraestrutura@ticto.com.br e devolve o access_token, que passa a ser enviado no header X-Api-Client-Token em todas as outras rotas.

Parâmetros obrigatórios (body)

string

required

ID do cliente fornecido durante o cadastro.

string

required

Token do cliente fornecido durante o cadastro.

Exemplo

cURL

curl -X POST https://nexus-sandbox.ticto.dev/api/v1/auth \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "client_id": "<seu_client_id>",
    "token": "<seu_token>"
  }'

Response de sucesso (200 OK)

string

required

Token de acesso do cliente (client_token). Envie-o no header X-Api-Client-Token nas demais rotas.

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

Sandbox e Produção têm pares de chaves distintos. Na virada para produção, repita esta chamada na base URL de produção com as credenciais produtivas. Veja Setup dos ambientes.

Erros mais comuns: 401 para credenciais incorretas e 422 quando falta client_id ou token no body.

Kickoff técnico

Primeira venda

Integração avançada

Regras

Parâmetros obrigatórios (body)

Exemplo

Response de sucesso (200 OK)

​Parâmetros obrigatórios (body)

​Exemplo

​Response de sucesso (200 OK)

Parâmetros obrigatórios (body)

Exemplo

Response de sucesso (200 OK)