> ## Documentation Index
> Fetch the complete documentation index at: https://t3sa.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Resumen de endpoints

> Todos los endpoints de la API de TESA, agrupados por recurso, con el alcance que exige cada uno

> [!WARNING]
>
> Borrador: especificación en curso. Los endpoints y campos pueden cambiar.

Las páginas de esta sección se generan a partir de la especificación OpenAPI 3.1 del repositorio (`es/api/openapi.yaml`, la versión en español de `api/openapi.yaml`). Todas las rutas son relativas a la URL base propuesta: `https://api.t3sa.com/v1` en producción o `https://sandbox.api.t3sa.com/v1` en el sandbox. Ninguna está activa todavía.

Las rutas de los recursos, los nombres de campos, los nombres de eventos y los códigos de error están en portugués por diseño y son los mismos en todos los idiomas de esta documentación.

Toda solicitud lleva `Authorization: Bearer <clave>`. Las solicitudes que cambian estado aceptan `Idempotency-Key` y, en la propuesta actual, la firma HMAC opcional con `Tesa-Timestamp` y `Tesa-Signature`. Vea [Autenticación](https://t3sa.com/docs/es/api/autenticacao.md).

### Organización

| Método | Ruta | Alcance | Operación |
| - | - | - | - |
| `GET` | [`/organizacao`](https://t3sa.com/docs/es/api/referencia/obter-organizacao) | `read` | Obtener organización |

### Billeteras

| Método | Ruta | Alcance | Operación |
| - | - | - | - |
| `GET` | [`/carteiras`](https://t3sa.com/docs/es/api/referencia/listar-carteiras) | `read` | Listar billeteras |
| `POST` | [`/carteiras`](https://t3sa.com/docs/es/api/referencia/vincular-carteira) | `admin` | Vincular billetera |
| `GET` | [`/carteiras/{id}`](https://t3sa.com/docs/es/api/referencia/obter-carteira) | `read` | Obtener billetera |
| `POST` | [`/carteiras/{id}/desvincular`](https://t3sa.com/docs/es/api/referencia/desvincular-carteira) | `admin` | Desvincular billetera |

### Posiciones

| Método | Ruta | Alcance | Operación |
| - | - | - | - |
| `GET` | [`/posicoes`](https://t3sa.com/docs/es/api/referencia/obter-posicoes) | `read` | Obtener posiciones |

### Política de asignación

| Método | Ruta | Alcance | Operación |
| - | - | - | - |
| `GET` | [`/politica-de-alocacao`](https://t3sa.com/docs/es/api/referencia/obter-politica-de-alocacao) | `read` | Obtener política de asignación |
| `PUT` | [`/politica-de-alocacao`](https://t3sa.com/docs/es/api/referencia/propor-nova-politica) | `admin` | Proponer nueva política (proporciones y reglas definidas por la empresa) |

### Propuestas

Las propuestas provienen de una regla de la política de la empresa (`origem: regra`) o de una solicitud de la propia empresa (`origem: manual`). TESA no recomienda asignaciones.

| Método | Ruta | Alcance | Operación |
| - | - | - | - |
| `GET` | [`/propostas`](https://t3sa.com/docs/es/api/referencia/listar-propostas) | `read` | Listar propuestas |
| `POST` | [`/propostas`](https://t3sa.com/docs/es/api/referencia/criar-proposta-de-rebalanceamento) | `propose` | Crear propuesta de rebalanceo |
| `GET` | [`/propostas/{id}`](https://t3sa.com/docs/es/api/referencia/obter-proposta) | `read` | Obtener propuesta |
| `POST` | [`/propostas/{id}/aprovar`](https://t3sa.com/docs/es/api/referencia/aprovar-proposta) | `admin` | Aprobar propuesta |
| `POST` | [`/propostas/{id}/rejeitar`](https://t3sa.com/docs/es/api/referencia/rejeitar-proposta) | `admin` | Rechazar propuesta |

### Rescates

| Método | Ruta | Alcance | Operación |
| - | - | - | - |
| `GET` | [`/resgates`](https://t3sa.com/docs/es/api/referencia/listar-resgates) | `read` | Listar rescates |
| `POST` | [`/resgates`](https://t3sa.com/docs/es/api/referencia/solicitar-resgate) | `propose` | Solicitar rescate |
| `GET` | [`/resgates/{id}`](https://t3sa.com/docs/es/api/referencia/obter-resgate) | `read` | Obtener rescate |
| `POST` | [`/resgates/{id}/aprovar`](https://t3sa.com/docs/es/api/referencia/aprovar-resgate) | `admin` | Aprobar rescate |

### Registros

| Método | Ruta | Alcance | Operación |
| - | - | - | - |
| `GET` | [`/registros`](https://t3sa.com/docs/es/api/referencia/listar-registros-on-chain) | `read` | Listar registros on-chain |

### Rendimiento y uso

| Método | Ruta | Alcance | Operación |
| - | - | - | - |
| `GET` | [`/rendimento`](https://t3sa.com/docs/es/api/referencia/consultar-rendimento) | `read` | Consultar rendimiento (informativo) |
| `GET` | [`/cobrancas`](https://t3sa.com/docs/es/api/referencia/listar-cobrancas) | `read` | Listar facturas de uso |
| `GET` | [`/cobrancas/{id}`](https://t3sa.com/docs/es/api/referencia/obter-cobranca) | `read` | Obtener factura de uso |

### Webhooks

| Método | Ruta | Alcance | Operación |
| - | - | - | - |
| `GET` | [`/webhooks`](https://t3sa.com/docs/es/api/referencia/listar-destinos-de-webhook) | `admin` | Listar destinos de webhook |
| `POST` | [`/webhooks`](https://t3sa.com/docs/es/api/referencia/cadastrar-destino-de-webhook) | `admin` | Registrar destino de webhook |

> [!NOTE]
>
> Ningún endpoint recibe una clave privada ni una transacción firmada. Tras la aprobación, las transacciones van a la empresa o a su custodio, que las firma y las transmite. El software sigue la confirmación on-chain y actualiza el estado.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.