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

# Errores

> Códigos de estado comunes y cómo resolverlos.

# Errores

La API devuelve errores como JSON con un campo `detail`:

```json theme={null}
{
  "detail": "Falta url."
}
```

## Códigos

| Status | Causa                                                                  | Solución                                                                                     |
| -----: | ---------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
|  `202` | Backends saturados; petición encolada.                                 | Pollea `GET /jobs/{job_id}` cada 5s hasta `completed`. Ver [Jobs](/docs/public/es/api/jobs). |
|  `400` | Cuerpo inválido o URL mal formada.                                     | Revisa el documento y la `url`.                                                              |
|  `401` | API key ausente o inválida.                                            | Envía un `x-api-key` válido.                                                                 |
|  `403` | Acceso no autorizado o host de URL no permitido.                       | Revisa tu key y la URL de origen.                                                            |
|  `413` | Documento demasiado grande, demasiadas páginas o ZIP fuera de límites. | Reduce el tamaño o divide el documento.                                                      |
|  `415` | Formato o `Content-Encoding` no soportado.                             | Usa un formato soportado; comprime solo con gzip o zstd.                                     |
|  `422` | Faltan parámetros.                                                     | Revisa `url`, `filename` e `input_format`.                                                   |
|  `429` | Demasiadas peticiones.                                                 | Aplica backoff y reintenta.                                                                  |
|  `500` | Error de conversión.                                                   | Prueba otro `mode` o verifica que el documento no esté corrupto.                             |

## Reintentos

* `429` y `5xx`: reintenta con backoff exponencial.
* `4xx` (salvo `429`): no reintentes sin corregir la petición.

<Tip />