# Integração via API

## Autenticação

A autenticação é baseada em `token`, que o administrador da conta adquire dentro do painel Troque & Devolva.

## Rate Limits

Nossa API possui limites de requisições para garantir a estabilidade e disponibilidade do serviço para todos os usuários.

### Limites Aplicados

A API controla o número de requisições de duas formas simultâneas:

#### Por Segundo

* **Requisições sem autenticação:** 1 requisição por segundo
* **Requisições autenticadas:** 15 requisições por segundo
* **Rotas públicas/frontend:** 5 requisições por segundo

#### Por Minuto

* **Requisições sem autenticação:** 60 requisições por minuto
* **Requisições autenticadas:** 1000 requisições por minuto
* **Rotas públicas/frontend:** 400 requisições por minuto

### Como Identificamos Você

* **Sem token (sem autenticação):** Identificamos pelo seu endereço IP
* **Com token válido:** Identificamos pelo token de autenticação fornecido

### O que Acontece ao Exceder o Limite

Quando você ultrapassar qualquer um dos limites, receberá:

* **Código de erro:** 429 (Too Many Requests)
* **Mensagem:** Informando qual limite foi excedido e quando tentar novamente
* **Headers na resposta:**
  * `X-RateLimit-Limit`: quantas requisições você pode fazer
  * `X-RateLimit-Remaining`: quantas requisições ainda restam
  * `Retry-After`: quantos segundos esperar antes de tentar novamente

### Recomendações

Para evitar bloqueios:

1. **Use tokens de autenticação,** você terá limites maiores
2. **Distribua suas requisições** ao longo do tempo em vez de fazer várias de uma vez
3. **Respeite o header Retry-After** quando receber erro 429
4. **Monitore o header X-RateLimit-Remaining** para saber quantas requisições ainda pode fazer

### Precisa de Limites Maiores?

Se sua aplicação precisa de limites personalizados, entre em contato com nosso suporte.

## Documentação

Estamos documentando completamente nossa API para permitir que você faça sua integraçãopersonalizada.

A documentação disponível no endereço: <https://docs.api.troqueedevolva.com.br/>

{% hint style="info" %}
Estamos aprimorando nossas explicações para torná-las mais claras e acessíveis. Em breve, nossa documentação de API incluirá exemplos de respostas de sucesso e erro, facilitando ainda mais o seu desenvolvimento.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.troqueedevolva.com.br/integracoes-externas/integracao-via-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.