> For the complete documentation index, see [llms.txt](https://guia-de-uso.tiflux.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guia-de-uso.tiflux.com/integracoes/api-tiflux/api-v1-descontinuada.md).

# API v1 - Descontinuada

{% hint style="danger" %}
Informamos que a API v1 foi **DESCONTINUADA.**

Para proporcionar uma melhor experiência ao usuário, lançamos a API v2, que traz melhorias tecnológicas, otimizações e novas rotas. 

Para mais detalhes e acesso à documentação oficial da API v2, [clique aqui.](https://api.tiflux.com/api/v2/#overview)
{% endhint %}

## Licença de acesso à API

Para obter acesso à **API Tiflux**, é necessário realizar a aquisição da licença de uso. 

Para mais informações referente a contratação entre em contato com o nosso [<mark style="color:orange;">suporte</mark>](https://www.tiflux.com.br/canal-suporte)!<br>

## Criando usuário e senha API

Ao realizar a contratação desta licença você precisará realizar as seguintes configurações:

1. &#x20;Configurações > Geral > Integrações > **Dados**.

<figure><img src="/files/fV9oTjR0vDndRpH281gr" alt=""><figcaption></figcaption></figure>

2. Insira um e-mail de acesso exclusivo do usuário analista de dados, clique em **Salvar e-mail.**<br>

<figure><img src="/files/AuTVF4S0Nnv5yv0fUbtq" alt=""><figcaption></figcaption></figure>

3. Você irá receber um e-mail para autorizar este e-mail como usuário de API, clique para autorizar.<br>

<figure><img src="/files/9di8hWRWJFbVDfQNaOq8" alt=""><figcaption></figcaption></figure>

4. Novamente no sistema, clique para gerar senha.

<figure><img src="/files/HCWh974oAhmCmXWFu2Lf" alt=""><figcaption></figcaption></figure>

5. Sua senha será gerada abaixo do campo de e-mail. Guarde-a em um local seguro, ao sair desta tela você não terá mais acesso a ela.

<figure><img src="/files/LHFld9MCJwnHiFvllkFW" alt=""><figcaption></figcaption></figure>

Com o e-mail e senha acima gerados, você poderá utilizar autorização do tipo Basic Auth.

<figure><img src="/files/Z5XhKSLcdNPD5gC1eg6s" alt=""><figcaption></figcaption></figure>

Você também poderá utilizar autenticação do tipo Basic/API Key\
Saiba mais em [<mark style="color:orange;">APIARY - Autenticação</mark>](https://tiflux.docs.apiary.io/#introduction/autenticacao).<br>

### Limitações

A API Tiflux permite que você faça até 120 requisições por minuto, então caso precise fazer muitas requisiçoes seguidas recomendamos colocar um intervalo entre as requisições.

### Códigos de resposta

Todas as respostas da API Tiflux vêm com um código de status HTTP. Cada código de status HTTP tem um significado, descrito abaixo.

`200 OK` - Solicitação realizada com sucesso.

`201 Created` - A solicitação foi realizada e seu objeto foi criado com sucesso.

`400 Bad Request` - Os parâmetros exigidos não foram enviados ou são inválidos. Neste caso, o corpo da resposta indicará qual é o problema.

`401 Unauthorized` - Sua API KEY não foi enviada ou é inválida.

`404 Not Found` - Endpoint ou objeto solicitado não existe

`422 Unprocessable Entity` - Ocorreu um erro ao tentar criar ou atualizar um objeto. O corpo da resposta indicará qual é o problema.

`500 Internal Server Error` - Algo deu errado na API Tiflux. Entre em contato com o suporte.

Todas as solicitações e respostas na API Tiflux estão no formato JSON.

## Apiary Tiflux

Saiba mais sobre as possibilidades de consumo e requisições API através da nossa [<mark style="color:orange;">documentação</mark>](https://tiflux.docs.apiary.io/#reference/0/clientes/listar-clientes).

<figure><img src="/files/nHvUBNreW8TefoUu5GDc" alt=""><figcaption></figcaption></figure>

[<mark style="color:orange;">**Ir para sumário das integrações**</mark>](/sistema/configuracoes/configuracoes-gerais/integracoes.md#sumario)