# Inspecionar endpoint

> URL: https://foura.ai/pt/docs/api/inspect
> Updated: 2026-09-30
> Index: https://foura.ai/llms.txt

Um endpoint público de diagnóstico que retorna o IP do seu cliente e detalhes de detecção de proxy. Use-o para verificar se o seu tráfego de saída está passando por um proxy antes de começar a enviar requests através do FourA.

## Request

`GET /inspect`

Este endpoint é público. Sem API key, sem header `X-API-Key`.

```bash
curl https://eu.api.foura.ai/inspect
```

## Response

```json
{
  "clientIp": "203.0.113.42",
  "proxyDetection": {
    "isProxy": false,
    "proxyType": "none",
    "anonymityLevel": "none",
    "confidence": "medium",
    "detectedHeaders": [],
    "explanation": "Direct connection (no client-side proxy detected). Note: Elite proxies cannot be ruled out without additional data."
  },
  "proxyChain": {
    "originalClientIp": "203.0.113.42",
    "proxyCount": 0,
    "hasPrivateIps": false
  },
  "timestamp": "2026-04-29T08:07:04.683Z"
}
```

### Campos de nível superior

| Campo | Tipo | Descrição |
|-------|------|-----------|
| `clientIp` | string | IP original do cliente (endereço mais à esquerda na cadeia encaminhada) |
| `proxyDetection` | object | Detecção de proxy e análise de anonimato |
| `proxyChain` | object | Detalhamento da cadeia de IP do lado do cliente |
| `timestamp` | string | Carimbo de data/hora ISO 8601 de quando a requisição foi inspecionada |

### `proxyDetection`

| Campo | Tipo | Descrição |
|-------|------|-----------|
| `isProxy` | boolean | Verdadeiro se cabeçalhos de proxy do lado do cliente foram detectados |
| `proxyType` | string | Um de: `transparent`, `anonymous`, `distorting`, `none` |
| `anonymityLevel` | string | Um de: `transparent`, `anonymous`, `none` |
| `confidence` | string | Confiança da detecção: `high`, `medium` ou `low` |
| `detectedHeaders` | string[] | Nomes de cabeçalho que indicaram um proxy (por exemplo, `via`, `forwarded`) |
| `explanation` | string | Resumo do resultado em texto simples |

### `proxyChain`

| Campo | Tipo | Descrição |
|-------|------|-----------|
| `originalClientIp` | string | Mesmo que o `clientIp` de nível superior |
| `proxyChain` | string[] | Lista de IPs de proxy entre você e a FourA, se houver |
| `proxyCount` | number | Número de proxies detectados na cadeia (0 = direto) |
| `via` | string[] | Conteúdo do cabeçalho `Via`, se presente |
| `hasPrivateIps` | boolean | Verdadeiro se algum IP privado/interno aparecer na cadeia |

## Tipos de proxy

| Tipo | O que significa |
|------|-----------------|
| `transparent` | Encaminha seu IP real e se identifica como um proxy |
| `anonymous` | Oculta seu IP real, mas se identifica como um proxy |
| `distorting` | Envia um IP de cliente falso para o destino |
| `none` | Nenhum cabeçalho de proxy visto: uma conexão direta ou um proxy que não envia nenhum |

## Quando usar isso

- Confirme se o seu tráfego de saída não está passando por um proxy corporativo ou túnel que você não esperava.
- Depure por que seu IP real aparece nos logs do site de destino, mesmo quando você achava que estava anônimo.
- Verifique se um proxy residencial ou rotativo está mascarando sua origem antes de enviar requisições pagas pela FourA.

Este endpoint inspeciona sua conexão com a FourA. Ele não testa a própria rede de proxies da FourA. Para verificar de qual IP se origina uma requisição roteada pela FourA, use o [endpoint de proxy](https://foura.ai/docs/api/endpoints) e leia a resposta.

## Limites

- Nenhuma autenticação necessária.
- Sujeito a um limite de taxa público generoso. Se você chamá-lo mais de algumas vezes por segundo a partir do mesmo IP, espere limitação de taxa.
- A resposta reflete apenas cabeçalhos e IPs. Ela não consegue detectar um proxy de elite perfeitamente transparente que remove todos os cabeçalhos de proxy.

## Relacionado

- [Endpoints da API](https://foura.ai/docs/api/endpoints): Os endpoints de requisição autenticada
- [Autenticação](https://foura.ai/docs/getting-started/authentication): Como autenticar o restante da API
- [Problemas comuns](https://foura.ai/docs/troubleshooting/common-issues): Depurar falhas de requisição
