---
title: Api2Pdf
slug: api2pdf
docTags: 
createdAt: 2025-05-28T05:11:27.530Z
---

## Objetivo

O conector **Api2Pdf** permite realizar operações com arquivos PDF e compactação, como *merge* de PDFs e geração de arquivos ZIP, utilizando a API pública da plataforma [api2pdf.com](https://www.api2pdf.com/). Ele é ideal para fluxos que exigem manipulação de documentos de forma automatizada e escalável.

## Configurando o conector Api2Pdf

### 1. Escolher o recurso

Ao adicionar o conector em um fluxo, selecione o recurso desejado. Atualmente está disponível:

- **PDF**

### 2. Escolher a operação

Após selecionar o recurso, será necessário definir a operação que será realizada. Neste momento, a operação disponível é:

- **Merge** (`POST` para `/pdfsharp/merge`)

Essa operação combina múltiplos arquivos PDF em um único documento.

### Parâmetros de entrada

### Recurso: PDF

| Campo     | Tipo   | Obrigatório | Descrição                                    |
| --------- | ------ | ----------- | -------------------------------------------- |
| operation | objeto | Sim         | Define a ação a ser executada no recurso PDF |

### Operação: Merge

| Campo | Tipo   | Obrigatório | Descrição                                                      |
| ----- | ------ | ----------- | -------------------------------------------------------------- |
| body  | string | Sim         | Define o formato do corpo da requisição. Pode ser:             |
|       |        |             | - `De/Para`: Estrutura mapeada manualmente.                    |
|       |        |             | - `Template`: Uso de um corpo de requisição baseado em modelo. |

***

## Comportamento interno

- **Método HTTP:** `POST`
- **Endpoint:** `/pdfsharp/merge`
- **Extensões utilizadas:**
  - `http_url`
  - `http_body_mapping` (se `De/Para`)
  - `http_body_template` (se `Template`)

***

## Testando o fluxo

1. Configure um passo anterior com os arquivos PDF de entrada.
2. Adicione o conector **Api2Pdf** e selecione:
   - Recurso: `PDF`
   - Operação: `Merge`
   - Corpo: `Template` ou `De/Para`, dependendo do formato desejado
3. Execute o fluxo.
4. O retorno será o novo documento PDF mesclado, pronto para ser utilizado ou armazenado.

### Exemplo de uso

### Entrada esperada (caso `body = Template`)

```json
{
  "resource": {
    "operation": {
      "body": "Template"
    }
  }
}
```