# Proxy

Estrutura de dados do contrato OpenAPI.

## Campos

| Campo | Tipo | Presença | Descrição |
|---|---|---|---|
| `mode` | `string` | obrigatório | Valores: `"custom"`, `"none"` |
| `effective_mode` | `string` | obrigatório | Valores: `"custom"`, `"none"` |
| `effective_detail` | `string` | opcional | Valores: `"direct"`, `"instance"`, `"sealed"` |
| `fallback` | `object` | obrigatório | — |
| `fallback.active` | `boolean` | opcional | Valores: `false` |
| `fallback.reason` | `string` | opcional | — |
| `fallback.since` | `integer` | opcional | — |
| `proxy_url` | `string` | obrigatório | Credenciais redigidas. |
| `proxy_fallback` | `string` | opcional | Valores: `"never"` |
| `managed` | `boolean` | opcional | Valores: `false` |
| `last_test_at` | `integer` | opcional | Unix em milissegundos. |
| `last_test_error` | `string` | opcional | — |
| `validation_error` | `boolean` | opcional | — |

## Definição OpenAPI

```json
{
  "type": "object",
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "custom",
        "none"
      ]
    },
    "effective_mode": {
      "type": "string",
      "enum": [
        "custom",
        "none"
      ]
    },
    "effective_detail": {
      "type": "string",
      "enum": [
        "direct",
        "instance",
        "sealed"
      ]
    },
    "fallback": {
      "type": "object",
      "properties": {
        "active": {
          "type": "boolean",
          "enum": [
            false
          ]
        },
        "reason": {
          "type": "string"
        },
        "since": {
          "type": "integer"
        }
      }
    },
    "proxy_url": {
      "type": "string",
      "description": "Credenciais redigidas."
    },
    "proxy_fallback": {
      "type": "string",
      "enum": [
        "never"
      ]
    },
    "managed": {
      "type": "boolean",
      "enum": [
        false
      ]
    },
    "last_test_at": {
      "type": "integer",
      "description": "Unix em milissegundos."
    },
    "last_test_error": {
      "type": "string"
    },
    "validation_error": {
      "type": "boolean"
    }
  },
  "required": [
    "mode",
    "effective_mode",
    "fallback",
    "proxy_url"
  ]
}
```