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

# Referencia de errores

> Cada error que puede devolver /submit - código, estado HTTP, y significado.

Cada error que devuelve `/submit` sigue la misma forma: el código de
estado HTTP correspondiente, más un cuerpo JSON con `success: false`, un
`code` estable, y un `message` legible para humanos.

```json theme={null}
{ "success": false, "code": "invalid_access_key", "message": "The access_key is not valid." }
```

`code` es la parte que vale la pena usar para ramificar la lógica, no
cambia entre versiones como sí podría hacerlo el texto de `message`. Si
estás construyendo un agente o cualquier código que necesite reaccionar a
un fallo específico (reintentar, pedir una corrección, mostrar un estado
de interfaz específico), lee `code`, no `message`.

## Todos los códigos

| Code                   | HTTP | Significado                                                                       |
| ---------------------- | ---- | --------------------------------------------------------------------------------- |
| `missing_access_key`   | 400  | No se proporcionó ningún access\_key.                                             |
| `invalid_access_key`   | 401  | El access\_key no es válido.                                                      |
| `invalid_body`         | 400  | El cuerpo de la solicitud no se pudo interpretar como JSON o datos de formulario. |
| `empty_submission`     | 400  | El envío no contenía ningún campo.                                                |
| `payload_too_large`    | 413  | El cuerpo de la solicitud es demasiado grande.                                    |
| `method_not_allowed`   | 405  | En este endpoint solo se permite POST.                                            |
| `domain_not_allowed`   | 403  | Este formulario no acepta envíos desde este dominio.                              |
| `internal_error`       | 500  | Ocurrió un error inesperado.                                                      |
| `rate_limited`         | 429  | Demasiadas solicitudes. Reduce la frecuencia e inténtalo de nuevo en un momento.  |
| `invalid_redirect`     | 400  | La URL de redirección no está permitida para este formulario.                     |
| `too_many_fields`      | 400  | El envío tiene demasiados campos.                                                 |
| `field_too_large`      | 400  | Un campo del envío es demasiado grande.                                           |
| `too_many_files`       | 400  | Demasiados archivos en este envío.                                                |
| `file_too_large`       | 413  | Un archivo subido es demasiado grande.                                            |
| `empty_file`           | 400  | Un archivo subido estaba vacío.                                                   |
| `storage_cap_exceeded` | 413  | Se alcanzó el límite de almacenamiento de archivos de esta cuenta.                |
| `upgrade_required`     | 403  | Esta función requiere un plan Pro.                                                |

## Usar esta tabla

* **Humanos**: compara el `code` que registró el manejador de errores de
  tu formulario (o el que se muestra en un envío de prueba fallido del
  panel) contra esta tabla para saber qué salió mal.
* **Agentes**: lee `code` para autocorregirte. `invalid_access_key`
  significa que debes revisar de nuevo la clave que conectaste;
  `domain_not_allowed` significa que el origen del envío todavía no está
  en la lista permitida del formulario; `upgrade_required` significa que
  el campo o función que intentas usar es exclusivo de Pro. Consulta
  [Solución de problemas y preguntas frecuentes](/docs/es/reference/troubleshooting-faq)
  para los casos más comunes mapeados a soluciones.

<CardGroup cols={2}>
  <Card title="Referencia de opciones" icon="sliders" href="/docs/es/reference/options">
    Los campos reservados y la configuración por formulario con la que se relaciona cada error.
  </Card>

  <Card title="Solución de problemas y preguntas frecuentes" icon="circle-question" href="/docs/es/reference/troubleshooting-faq">
    Problemas comunes, mapeados a los códigos de arriba.
  </Card>
</CardGroup>