# KCS - Utilização e Testes no Tiflux da API V2

## 🤖 Utilização e Testes no Tiflux da API V2

🕒 Tempo aproximado para leitura: 00:01:30 min

***

### ❓ Dúvida

Como realizar testes de rotas ou importar a documentação da API Tiflux V2 para ferramentas externas como o Postman?

***

### 🔎 Causa

Necessidade de validar integrações, realizar operações via API (GET, POST, PUT, etc.) ou automatizar processos de forma simplificada.

***

### ✅ Solução

Para utilizar a API, você pode optar pela documentação interativa ou por ferramentas externas:

* Uso no Postman: Acesse a página oficial da API e clique no botão Download OpenAPI spec. Importe o arquivo baixado diretamente no Postman para carregar todas as rotas e coleções.

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FWS5iouHvOrbRFbq4kjyO%2Fimage.png?alt=media&#x26;token=11c6dcc8-9978-4933-a9a2-4bf522d4a498" alt=""><figcaption></figcaption></figure>

* Autenticação na Documentação:
  1. Acesse o link oficial: [api.tiflux.com/api/v2/#auth](https://api.tiflux.com/api/v2/#auth).
  2. Gere seu token no sistema Tiflux em Minha Conta > Sessões.
  3. Na documentação, clique em Authentication no menu lateral, insira o token no campo api-token e clique em SET.

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FP77YgBnUlmVTZipzHOWs%2Fimage.png?alt=media&#x26;token=204e1ed9-ddaf-48ce-acf8-e57b3aa492a4" alt=""><figcaption></figcaption></figure>

* Execução de Requisições: Com o token configurado, navegue pelo menu à esquerda, selecione a rota desejada e execute os testes diretamente pela interface da documentação.
