> 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-v2.md).

# API v2

## 🔌 Integração e Automação: Entendendo a API v2

```
📍 Endpoint Base:
🌐 https://api.tiflux.com/api/v2 (Obrigatório o uso de HTTPS)
```

***

### 🎯 Para o que serve?

A API v2 serve essencialmente como uma ponte de comunicação inteligente entre sistemas. Ela permite que outros softwares ou plataformas externas se conectem ao Tiflux para "pedir" dados ou enviar "instruções" automáticas, sem que um sistema precise entender como o outro foi programado internamente.

Na prática, ela é utilizada para:

* Conectar diferentes serviços: Integrar o Tiflux ao seu CRM, ERP ou sistema financeiro.
* Automatizar tarefas: Evitar o trabalho manual de copiar informações de um sistema para o outro.
* Expandir funcionalidades: Permitir que ações aconteçam em tempo real (como abrir um ticket automaticamente quando um alerta de monitoramento for gerado).

Para acessar a documentação completa da API v2, [clique aqui.](https://api.tiflux.com/api/v2/#overview)

***

### 📚 Sumário

💡 Exemplo Prático de Uso

🔑 Modelo de Licenciamento

🚦 Limites de Tráfego (Rate Limit)

🛠️ Padrões e Convenções Técnicas

***

### 📘 Detalhamento da Ferramenta

#### 💡 Exemplo Prático de Uso

Pense na API como um mensageiro. Quando você usa um aplicativo de clima no celular, ele não adivinha o tempo; ele faz uma requisição para a API de um serviço meteorológico (como o *OpenWeather*), que devolve os dados de temperatura e umidade para o app exibir na sua tela. No Tiflux é igual: seu sistema externo pede informações à API, e ela responde com os dados precisos com total segurança e eficiência.

#### 🔑 Modelo de Licenciamento

* Vinculada por Usuário: A licença da API v2 é atrelada a um usuário específico já registrado na base do Tiflux.
* Flexibilidade: Você pode adquirir múltiplas licenças de API. Isso possibilita que cada usuário/integração tenha níveis de acesso e permissões diferenciados dentro do sistema, garantindo maior controle de segurança.

#### 🚦 Limites de Tráfego (Rate Limit)

Para garantir a estabilidade do servidor e a segurança de toda a operação, a API v2 possui uma trava padrão:

* Capacidade: Até 120 requisições por minuto.
* *Nota: Caso sua operação necessite de um volume maior de requisições, é possível negociar planos expandidos diretamente com o seu Customer Success Manager (CSM)* da sua conta [clicando aqui.](https://api.whatsapp.com/send?phone=551142008293)

#### 🛠️ Padrões e Convenções Técnicas

A API foi desenvolvida sob os padrões mais modernos do mercado de tecnologia:

* Padrão RESTful: Utiliza os métodos globais de requisição HTTP:
  * `GET` (para buscar informações).
  * `POST` (para criar novos registros, como um ticket).
  * `PUT` (para atualizar dados existentes).
  * `DELETE` (para remover registros).
* Formato JSON: Tanto o envio de dados quanto as respostas do servidor são codificados em formato JSON, que é leve e universalmente lido por qualquer linguagem de programação.

***

### ⚠️ Avisos importantes

> Segurança em Primeiro Lugar: O uso do protocolo HTTPS é obrigatório para todas as requisições. Isso garante que os dados trafeguem de forma criptografada entre os sistemas.
>
> Desenvolvimento: Antes de iniciar qualquer integração, os seus desenvolvedores devem consultar a documentação técnica completa fornecida pela plataforma para mapear corretamente os endpoints.

***

### 🔍 Palavras-chave para busca

```
o que é api,
integração tiflux,
api v2 restful,
automação de sistemas,
limite requisições api,
json api,
segurança https,
licença por usuário api
```