# Conceptos de la API

[HTML](https://pdfcraft.ai/es-ES/docs/api/overview/) · [Site index](https://pdfcraft.ai/llms.txt)

Comprende la autenticación, las tareas asíncronas y el ciclo de vida de la API de conversión de documentos.


La API de PDF Craft se basa en REST, usa solicitudes y respuestas JSON y autentica cada solicitud mediante una clave de API Bearer.

## URL base y autenticación

Todos los endpoints están disponibles bajo `https://fusion-api.oomol.com/v1`. Envía la clave de API mediante el encabezado `Authorization`.

```text
Authorization: Bearer YOUR_API_KEY
```

No expongas esta clave en el código de frontend. Dirige el trabajo iniciado desde el navegador a través de tu propio backend.

## Ciclo de vida de tareas asíncronas

La conversión de documentos es asíncrona. Un endpoint de envío devuelve `sessionID`, el identificador de tarea, y el endpoint de resultado correspondiente comunica uno de estos estados:

- `processing`: el archivo está esperando o se está convirtiendo.
- `completed`: el resultado contiene la URL de salida generada en `data.downloadURL` y los metadatos.
- `failed`: el resultado contiene una razón de error que tu aplicación debe mostrar o registrar.

Tu integración debe dejar de consultar al llegar a un estado final, usar reintentos limitados y conservar el ID de tarea para soporte y recuperación.

## Endpoints

La API actual admite conversión de PDF a Markdown y de PDF a EPUB. Consulta la [Referencia de la API](https://pdfcraft.ai/es-ES/api/) completa para rutas, parámetros, cargas de ejemplo y guías de SDK de Python y TypeScript.