# Univer PDFs API

> Cree, busque, guarde, abra y descargue unidades PDF mediante PDF Facade API.

- Human documentation: [https://docs.univer.ai/es-ES/guides/pdfs/features/core/pdfs-api](https://docs.univer.ai/es-ES/guides/pdfs/features/core/pdfs-api)

- Agent Markdown: [https://docs.univer.ai/es-ES/guides/pdfs/features/core/pdfs-api.md](https://docs.univer.ai/es-ES/guides/pdfs/features/core/pdfs-api.md)

- Requested language: `es-ES`

- Content language: `es-ES`

- Documentation version: `1.2.0`

- Source: [pdfs/features/core/pdfs-api.es-ES.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/pdfs/features/core/pdfs-api.es-ES.mdx)

---

PDF Facade añade unidades PDF y puntos de entrada de página a `FUniver`. Importe su entrada de efecto secundario antes de crear el objeto API.

## Habilitar PDF Facade

```ts
import { FUniver } from '@univerjs/core/facade'

import '@univerjs-pro/pdfs/facade'

const univerAPI = FUniver.newAPI(univer)
```

Registre `UniverPdfsPlugin` en la instancia de Univer para que la aplicación pueda alojar unidades PDF.

## Crear, buscar y guardar unidades PDF

Cuando se omite `document`, `createPdf()` crea una unidad con una página A4 en blanco. Pase una instantánea devuelta previamente por `save()` para restaurar una unidad.

```ts
const pdf = univerAPI.createPdf({
  id: 'project-brief',
  name: 'Project brief',
})

const activePdf = univerAPI.getActivePdf()
const samePdf = univerAPI.getPdf(pdf.getId())
const snapshot = pdf.save()
```

Use métodos Facade o comandos para actualizar un PDF en ejecución. Trate la instantánea guardada como datos de persistencia independientes.

## Entrar en una página

`FPdfPage` es el punto de entrada común para las superposiciones editables y el texto nativo importado de una página:

```ts
const firstPage = pdf.getPageByIndex(0) ?? pdf.insertPage()
const elements = firstPage.getElements()
const nativeText = firstPage.getTextSpans()
```

Continúe con [Páginas y elementos](https://docs.univer.ai/es-ES/guides/pdfs/features/core/pages-and-elements.md), [Texto y listas](https://docs.univer.ai/es-ES/guides/pdfs/features/core/text-and-lists.md), [Tablas](https://docs.univer.ai/es-ES/guides/pdfs/features/core/tables.md), [Imágenes y divisores](https://docs.univer.ai/es-ES/guides/pdfs/features/core/images-and-dividers.md) o [Anotaciones y texto nativo](https://docs.univer.ai/es-ES/guides/pdfs/features/core/annotations-and-native-text.md) para operaciones específicas.

## Descargar una unidad PDF

Descargue una unidad PDF por su ID cuando deje de necesitarla. Destruya la instancia raíz `univer` solo cuando se cierre toda la aplicación.

```ts
const pdf = univerAPI.getActivePdf()

if (pdf) {
  univerAPI.disposeUnit(pdf.getId())
}
```

Para ver las firmas y los tipos de retorno exactos, consulte la [referencia de PDF Facade](https://docs.univer.ai/es-ES/reference/facade/pdf.md).