Como obter um Access Token para acessar a API

Como obter um Access Token para acessar a API do Kazah

Para consumir a API do Kazah, é necessário obter um access token através do fluxo OAuth 2.0 com o grant type client_credentials.

Endpoint para geração de Token

URL: https://api.kazah.io/auth/token
Método: GET
Content-Type: application/x-www-form-urlencoded

Parâmetros obrigatórios:

Parâmetro	Descrição
`client_id`	Seu identificador de cliente
`client_secret`	Sua chave secreta de cliente
`grant_type`	Tipo de autenticação (`client_credentials`)

✅ Exemplo de Requisição com `curl`

curl --location --request GET 'https://api.kazah.io/auth/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'client_id=SUA_CLIENT_ID_AQUI' \
--data-urlencode 'client_secret=SUA_CLIENT_SECRET_AQUI' \
--data-urlencode 'grant_type=client_credentials'

Resposta esperada (JSON)

{
  "access_token": "seu_access_token_aqui",
  "token_type": "bearer",
  "expires_in": 3599
}

O token expira em cerca de 1 hora (3599 segundos). Guarde-o temporariamente em cache para evitar requisições desnecessárias.

Como usar o Access Token nas chamadas à API

Depois de obter o token, você deve incluí-lo no cabeçalho Authorization de cada requisição às rotas protegidas da API.

Exemplo de chamada autenticada

curl --location 'https://api.kazah.io/app/apiv1/contatos/0/100' \
--header 'Authorization: Bearer SEU_ACCESS_TOKEN_AQUI'

Documentação dos Endpoints

A documentação completa dos endpoints disponíveis na API está em:
https://api.kazah.io/docs

Dicas

Substitua SUA_CLIENT_ID_AQUI e SUA_CLIENT_SECRET_AQUI encontrados nas configurações no ambiente do Kazah.
O uso do header Authorization: Bearer é obrigatório para autenticação.
Mantenha suas credenciais seguras. Não exponha seu client_secret em ambientes públicos.

Como obter um Access Token para acessar a API