# Formatos de respuesta y negociación de contenido Qué devuelve una acción y cómo la cabecera Accept elige entre un PDF, un ZIP, un sobre JSON y multipart/mixed. La mayoría de las acciones devuelve un único documento `application/pdf`. Las cuatro acciones de división devuelven varios documentos a la vez, y usted elige cómo se empaquetan con la cabecera de solicitud `Accept`. Esta página es la referencia de esa negociación de contenido: las opciones de empaquetado, el esquema del sobre JSON y qué ocurre cuando una cabecera `Accept` no coincide con nada. ## Respuestas de un solo documento Toda acción que no sea de división responde con `200 OK` y el PDF procesado como cuerpo en crudo: ```http HTTP/1.1 200 OK Content-Type: application/pdf Content-Length: 48213 ``` No hay nada que negociar: escriba el cuerpo en un archivo, como hacen los ejemplos de cada página de acción. ## Respuestas de varios documentos La familia de división devuelve varios documentos en una sola llamada: [Dividir por número de páginas](/docs/api/split-pdf-by-page-count), [Dividir en una página](/docs/api/split-pdf-at-page), [Dividir por tamaño de archivo](/docs/api/split-pdf-by-file-size) y [Dividir en grupos de páginas](/docs/api/split-pdf-into-page-groups). Los documentos de salida se llaman `00001.pdf`, `00002.pdf` y así sucesivamente, en orden. El empaquetado se selecciona con la cabecera de solicitud `Accept`: | Cabecera `Accept` | Respuesta | | -------------------- | -------------------------------------------------------------- | | *(no se envía)* | `application/zip`: la opción predeterminada | | `application/zip` | Un archivo ZIP con los PDF de salida | | `application/json` | Un sobre JSON con los documentos codificados en base64 | | `multipart/mixed` | Un PDF por parte | | cualquier otra cosa | `406 Not Acceptable` | ### application/zip: la opción predeterminada Sin cabecera `Accept` (o con `Accept: application/zip`), la respuesta es un archivo ZIP cuyas entradas se llaman `00001.pdf`, `00002.pdf`, y así sucesivamente: ```bash title="cURL" curl https://api.pdfblocks.com/v1/split_by_page_count \ -H 'X-API-Key: your_api_key' \ -F file=@input.pdf \ -F page_count=10 \ -o parts.zip ``` Descomprima `parts.zip` para obtener los documentos individuales. ### application/json: el sobre en base64 Solicite `Accept: application/json` para recibir todos los documentos en línea en una sola respuesta JSON, práctico cuando quiere mantener las partes en memoria o reenviarlas sin tocar el sistema de archivos: ```bash title="cURL" curl https://api.pdfblocks.com/v1/split_by_page_count \ -H 'X-API-Key: your_api_key' \ -H 'Accept: application/json' \ -F file=@input.pdf \ -F page_count=10 \ -o parts.json ``` El cuerpo es una matriz `documents`; cada entrada lleva su nombre y sus bytes codificados en base64: ```json { "documents": [ { "name": "00001.pdf", "content": "JVBERi0xLjcKJeLjz9MK... (base64)", "content_type": "application/pdf" }, { "name": "00002.pdf", "content": "JVBERi0xLjcKJeLjz9MK... (base64)", "content_type": "application/pdf" } ] } ``` <ParamField name="documents" type="array" required> Los documentos PDF de salida, en orden. </ParamField> <ParamField name="documents[].name" type="string" required> El nombre del documento: `00001.pdf`, `00002.pdf` y así sucesivamente. </ParamField> <ParamField name="documents[].content" type="string (base64)" required> El documento PDF codificado en base64. Decodifíquelo para recuperar los bytes originales del PDF. </ParamField> <ParamField name="documents[].content_type" type="string" required> El tipo de medio del documento: `application/pdf`. </ParamField> ### multipart/mixed: una parte por documento Solicite `Accept: multipart/mixed` para recibir los documentos como un cuerpo multipart con una parte por cada PDF de salida, en orden. Cada parte tiene un `Content-Type` de `application/pdf` y un `Content-Disposition` que la nombra `00001.pdf`, `00002.pdf` y así sucesivamente. ```bash title="cURL" curl https://api.pdfblocks.com/v1/split_by_page_count \ -H 'X-API-Key: your_api_key' \ -H 'Accept: multipart/mixed' \ -F file=@input.pdf \ -F page_count=10 \ -o parts.multipart ``` ## Un Accept sin coincidencia devuelve 406 Si envía una cabecera `Accept` que no coincide con ninguno de los tres formatos anteriores, por ejemplo `Accept: application/pdf` en una acción de división, la API responde con `406 Not Acceptable` y un cuerpo `application/problem+json`. Omita `Accept` para tomar el ZIP predeterminado, o solicite uno de los tipos de medio admitidos. Consulte [Errores](/docs/api/errors) para ver la forma del detalle del problema. <Tip> Para ver código de principio a fin que llama a una acción de división y desempaqueta cada formato, ya sea extrayendo el ZIP, decodificando el sobre JSON o leyendo las partes multipart, consulte la guía [Dividir un PDF](/docs/api/splitting-a-pdf). </Tip>