---
title: "API: referencia de endpoints — Documentación | WordPane Cloud"
url: "https://wordpane.cloud/es/documentacao/api-referencia/"
description: "Endpoints, permisos, límites y respuestas de la API v1."
language: "es"
generatedAt: "2026-10-31T14:05:07.042Z"
contentType: "public-page"
pricingSource: "https://app.wordpane.cloud/api/public/plan-catalog"
---

[Centro de documentación](https://wordpane.cloud/es/documentacao/)

API e integraciones

# API: referencia de endpoints

Endpoints, permisos, límites y respuestas de la API v1.

**Documentación técnica del área de clientes**

Los ejemplos usan datos ficticios y no ejecutan solicitudes en esta página. Nunca introduzca su credencial real aquí.

## Consulte los endpoints disponibles

URL base: https://app.wordpane.cloud/api/v1. La tabla se genera desde la especificación OpenAPI publicada. Las rutas son relativas a la URL base. Abra el contrato actualizado para consultar parámetros y esquemas de cada operación.

[Abrir OpenAPI 3.1 actualizado](https://app.wordpane.cloud/api/v1/openapi.json)

| Método y ruta | Operación | Permisos |
| --- | --- | --- |
| `GET /servers` | Listar servidores | `servers.read` |
| `GET /email-domains` | Listar dominios | `emails.read` |
| `GET /mailboxes` | Listar buzones | `emails.read` |
| `GET /tickets` | Listar tickets | `tickets.read` |
| `GET /servers/{id}` | Detalles del servidor | `servers.read` |
| `GET /servers/{id}/installation` | Estado registrado de instalación | `servers.read` |
| `GET /email-domains/{id}/mailboxes` | Buzones del dominio | `emails.read` |
| `GET /tickets/{id}` | Detalles del ticket | `tickets.read` |
| `GET /tickets/{id}/messages` | Mensajes del ticket | `tickets.read` |
| `POST /tickets/{id}/messages` | Responder a un ticket sin duplicados | `tickets.read`    `tickets.reply` |
| `GET /balance` | Saldo de toda la cuenta en BRL | `billing.read` |
| `GET /ledger` | Extracto de toda la cuenta | `billing.read` |

## Gestione errores y límites

El límite es de 60 solicitudes por minuto por credencial, además del límite global por origen. En 429, respete Retry-After. Para fallos temporales, use esperas progresivas. X-Request-Id identifica la solicitud para soporte; no envíe su credencial al pedir ayuda.

### Permisos y detalles

**`401`**: Credencial inválida, caducada o revocada.

**`403`**: Permisos insuficientes o acceso del responsable no disponible.

**`404`**: Recurso inexistente o fuera del acceso autorizado.

**`409`**: Conflicto de idempotencia o ticket cerrado.

**`422`**: Parámetros inválidos; revise el campo errors.

**`429`**: Límite alcanzado; espere antes de reintentar.

**`500`**: Fallo temporal; informe X-Request-Id al soporte.

## Conozca el alcance de la versión

La API v1 permite consultas y respuestas a tickets con autorización específica. No permite contratar, eliminar recursos, pagar, acceder por SSH ni obtener contraseñas. La instalación consulta el estado registrado; no es un flujo de métricas en vivo. Use OpenAPI como contrato actual.

Actualizado el 17 de octubre de 2026.

[Consultar otras guías](https://wordpane.cloud/es/documentacao/)

---
Fonte oficial: https://wordpane.cloud/es/documentacao/api-referencia/
Esta é uma representação da página pública. A data de geração não indica alteração editorial.