# Obter configuração de proxy

`GET /instance/proxy`

Pasta: **Proxy**

## Autenticação

```http
token: {{token}}
```

## Descrição

# Obter configuração de proxy

Retorna o modo e o estado do proxy da instância. Use para conferir se a saída está em `dynamic`, `global`, `custom` ou `managed` antes de alterar.

## Endpoint

`GET {{baseUrl}}/instance/proxy`

## Autenticação

Envie o token da instância no header `token: {{token}}`.

## Exemplo de Requisição

```bash
curl --request GET '{{baseUrl}}/instance/proxy' \
  --header 'token: {{token}}'
```

## Resposta de Sucesso

Modo dinâmico (padrão / mobile):

```json
{
  "success": true,
  "proxy": {
    "mode": "dynamic",
    "enabled": true
  }
}
```

Modo custom/global (exemplo):

```json
{
  "success": true,
  "proxy": {
    "mode": "custom",
    "enabled": true,
    "proxy_url": "socks5://user:pass@proxy.exemplo.com:1080",
    "url": "socks5://user:pass@proxy.exemplo.com:1080"
  }
}
```

## Erros comuns

- `401 Unauthorized`: header `token` ausente ou inválido.

## Observações

- Em instâncias mobile o modo efetivo exposto é tratado como `dynamic`.
- Em `global`, a resposta pode incluir `resolved` com a URL normalizada do proxy do servidor.

## cURL

```bash
curl -X GET "{{baseUrl}}/instance/proxy" \
  -H "token: {{token}}"
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=proxy/obter-configuracao-de-proxy)