# Dividir un PDF en una página Divida un PDF en dos documentos en el límite de una página: todo lo anterior a la página de corte y, después, la página de corte y lo que sigue. Divida un documento PDF en dos documentos en el límite de una página: las páginas anteriores a la página de corte forman la primera parte, y la página de corte y todo lo que sigue forman la segunda. Esta acción devuelve varios documentos, aquí exactamente dos partes, empaquetados en una sola respuesta según la cabecera `Accept`. La API es *stateless*: su documento se procesa en la región y nunca se almacena. ## Endpoint Disponible en todas las regiones. Consulte [Regiones y residencia de datos](/docs/api/regions-and-data-residency) para el enrutamiento y la residencia de datos. | Región | URL | | ---------------- | --------------------------------------------------- | | Global | `https://api.pdfblocks.com/v1/split_at_page` | | Estados Unidos | `https://us.api.pdfblocks.com/v1/split_at_page` | | HIPAA de EE. UU. | `https://hipaa.api.pdfblocks.com/v1/split_at_page` | | Unión Europea | `https://eu.api.pdfblocks.com/v1/split_at_page` | | Reino Unido | `https://uk.api.pdfblocks.com/v1/split_at_page` | | Canadá | `https://ca.api.pdfblocks.com/v1/split_at_page` | | Australia | `https://au.api.pdfblocks.com/v1/split_at_page` | | Japón | `https://jp.api.pdfblocks.com/v1/split_at_page` | | India | `https://in.api.pdfblocks.com/v1/split_at_page` | | Brasil | `https://br.api.pdfblocks.com/v1/split_at_page` | ## Autenticación Autentique cada solicitud con su clave de API secreta en la cabecera `X-API-Key`, por HTTPS. Cree y administre sus claves desde el [dashboard](https://dashboard.pdfblocks.com). Consulte [Autenticación](/docs/api/authentication) para más detalles. ## Solicitud El endpoint acepta un cuerpo de solicitud `multipart/form-data`. El documento PDF de entrada. El número de página con el que empieza la segunda parte. Debe estar entre `2` y el número de páginas del documento, para que ambas partes contengan páginas. ## Ejemplos Divida un documento en dos partes en la página 5: ```bash title="cURL" curl https://api.pdfblocks.com/v1/split_at_page \ -H 'X-API-Key: your_api_key' \ -F file=@input.pdf \ -F page=5 \ -o parts.zip ``` ```python title="Python" # pip install requests import requests with open('input.pdf', 'rb') as file: response = requests.post( 'https://api.pdfblocks.com/v1/split_at_page', headers={'X-API-Key': 'your_api_key'}, files={'file': file}, data={'page': 5}, ) response.raise_for_status() with open('parts.zip', 'wb') as output: output.write(response.content) ``` ```javascript title="Node.js" // Node.js 18+ import { readFile, writeFile } from 'node:fs/promises'; const body = new FormData(); body.set('file', new Blob([await readFile('input.pdf')]), 'input.pdf'); body.set('page', '5'); const response = await fetch('https://api.pdfblocks.com/v1/split_at_page', { method: 'POST', headers: { 'X-API-Key': 'your_api_key' }, body, }); if (!response.ok) throw new Error(`Request failed: ${response.status}`); await writeFile('parts.zip', Buffer.from(await response.arrayBuffer())); ``` ```php title="PHP" true, CURLOPT_HTTPHEADER => ['X-API-Key: your_api_key'], CURLOPT_POST => true, CURLOPT_POSTFIELDS => [ 'file' => new CURLFile('input.pdf', 'application/pdf'), 'page' => '5', ], ]); $zip = curl_exec($ch); if (curl_getinfo($ch, CURLINFO_HTTP_CODE) === 200) { file_put_contents('parts.zip', $zip); } ``` ```ruby title="Ruby" # gem install http require 'http' response = HTTP .headers('X-API-Key' => 'your_api_key') .post('https://api.pdfblocks.com/v1/split_at_page', form: { file: HTTP::FormData::File.new('input.pdf'), page: '5', }) File.write('parts.zip', response.body) if response.status.success? ``` ```go title="Go" package main import ( "bytes" "io" "mime/multipart" "net/http" "os" ) func main() { var buf bytes.Buffer form := multipart.NewWriter(&buf) file, _ := os.Open("input.pdf") defer file.Close() part, _ := form.CreateFormFile("file", "input.pdf") io.Copy(part, file) form.WriteField("page", "5") form.Close() req, _ := http.NewRequest("POST", "https://api.pdfblocks.com/v1/split_at_page", &buf) req.Header.Set("Content-Type", form.FormDataContentType()) req.Header.Set("X-API-Key", "your_api_key") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() out, _ := os.Create("parts.zip") defer out.Close() io.Copy(out, res.Body) } ``` ```csharp title="C#" using var client = new HttpClient(); client.DefaultRequestHeaders.Add("X-API-Key", "your_api_key"); using var form = new MultipartFormDataContent { { new ByteArrayContent(File.ReadAllBytes("input.pdf")), "file", "input.pdf" }, { new StringContent("5"), "page" }, }; var response = await client.PostAsync( "https://api.pdfblocks.com/v1/split_at_page", form); response.EnsureSuccessStatusCode(); await File.WriteAllBytesAsync( "parts.zip", await response.Content.ReadAsByteArrayAsync()); ``` El ZIP contiene exactamente dos documentos: `00001.pdf` contiene las páginas 1 a 4 y `00002.pdf` contiene desde la página 5 hasta el final. ## Respuesta Esta acción devuelve varios documentos, empaquetados en una sola respuesta según la cabecera de solicitud `Accept`: consulte [Formatos de respuesta y negociación de contenido](/docs/api/response-formats) para ver la referencia completa de la negociación. Sin cabecera `Accept`, la opción predeterminada es un archivo ZIP: ```http HTTP/1.1 200 OK Content-Type: application/zip ``` Seleccione el empaquetado con la cabecera `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` | La salida es siempre exactamente dos documentos: `00001.pdf`, con las páginas anteriores a la página de corte, y `00002.pdf`, con la página de corte y todo lo que sigue. 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). ## Errores Las solicitudes fallidas devuelven un cuerpo `application/problem+json`. El error más habitual en este endpoint es un `400`, que se devuelve cuando falta `page` o está fuera de rango, o cuando `file` no es un PDF legible: el objeto `errors` nombra cada campo: ```json { "type": "https://www.pdfblocks.com/docs/api/v1/error/400", "title": "One or more validation errors occurred.", "status": 400, "errors": { "page": ["The field page must be between 2 and the number of pages in the document."] } } ``` Si la cabecera `Accept` no coincide con `application/zip`, `application/json` ni `multipart/mixed`, por ejemplo `Accept: application/pdf`, la API responde con `406 Not Acceptable`. Omita `Accept` para tomar el ZIP predeterminado, o solicite uno de los tipos de medio admitidos. Una `X-API-Key` ausente o no válida devuelve un `401`. Consulte [Errores](/docs/api/errors) para ver todos los códigos de estado y la forma completa de la respuesta. ## Recetas Una variante habitual. Despliéguela para ver el código en todos los lenguajes. Envíe `Accept: application/json` para recibir todas las partes en línea en una sola respuesta y después decodifique de base64 el `content` de cada entrada en un archivo con el nombre de su `name`: ```bash title="cURL" curl https://api.pdfblocks.com/v1/split_at_page \ -H 'X-API-Key: your_api_key' \ -H 'Accept: application/json' \ -F file=@input.pdf \ -F page=5 \ | jq -r '.documents[] | .name + " " + .content' \ | while read -r name content; do echo "$content" | base64 --decode > "$name" done ``` ```python title="Python" # pip install requests import base64 import requests with open('input.pdf', 'rb') as file: response = requests.post( 'https://api.pdfblocks.com/v1/split_at_page', headers={ 'X-API-Key': 'your_api_key', 'Accept': 'application/json', }, files={'file': file}, data={'page': 5}, ) response.raise_for_status() for document in response.json()['documents']: with open(document['name'], 'wb') as output: output.write(base64.b64decode(document['content'])) ``` ```javascript title="Node.js" // Node.js 18+ import { readFile, writeFile } from 'node:fs/promises'; const body = new FormData(); body.set('file', new Blob([await readFile('input.pdf')]), 'input.pdf'); body.set('page', '5'); const response = await fetch('https://api.pdfblocks.com/v1/split_at_page', { method: 'POST', headers: { 'X-API-Key': 'your_api_key', Accept: 'application/json' }, body, }); if (!response.ok) throw new Error(`Request failed: ${response.status}`); const { documents } = await response.json(); for (const doc of documents) { await writeFile(doc.name, Buffer.from(doc.content, 'base64')); } ``` ```php title="PHP" true, CURLOPT_HTTPHEADER => [ 'X-API-Key: your_api_key', 'Accept: application/json', ], CURLOPT_POST => true, CURLOPT_POSTFIELDS => [ 'file' => new CURLFile('input.pdf', 'application/pdf'), 'page' => '5', ], ]); $body = curl_exec($ch); if (curl_getinfo($ch, CURLINFO_HTTP_CODE) === 200) { foreach (json_decode($body, true)['documents'] as $document) { file_put_contents($document['name'], base64_decode($document['content'])); } } ``` ```ruby title="Ruby" # gem install http require 'base64' require 'http' require 'json' response = HTTP .headers('X-API-Key' => 'your_api_key', 'Accept' => 'application/json') .post('https://api.pdfblocks.com/v1/split_at_page', form: { file: HTTP::FormData::File.new('input.pdf'), page: '5', }) if response.status.success? JSON.parse(response.body)['documents'].each do |document| File.write(document['name'], Base64.decode64(document['content'])) end end ``` ```go title="Go" package main import ( "bytes" "encoding/base64" "encoding/json" "io" "mime/multipart" "net/http" "os" ) func main() { var buf bytes.Buffer form := multipart.NewWriter(&buf) file, _ := os.Open("input.pdf") defer file.Close() part, _ := form.CreateFormFile("file", "input.pdf") io.Copy(part, file) form.WriteField("page", "5") form.Close() req, _ := http.NewRequest("POST", "https://api.pdfblocks.com/v1/split_at_page", &buf) req.Header.Set("Content-Type", form.FormDataContentType()) req.Header.Set("X-API-Key", "your_api_key") req.Header.Set("Accept", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() var result struct { Documents []struct { Name string `json:"name"` Content string `json:"content"` } `json:"documents"` } json.NewDecoder(res.Body).Decode(&result) for _, doc := range result.Documents { data, _ := base64.StdEncoding.DecodeString(doc.Content) os.WriteFile(doc.Name, data, 0644) } } ``` ```csharp title="C#" using System.Text.Json; using var client = new HttpClient(); client.DefaultRequestHeaders.Add("X-API-Key", "your_api_key"); client.DefaultRequestHeaders.Add("Accept", "application/json"); using var form = new MultipartFormDataContent { { new ByteArrayContent(File.ReadAllBytes("input.pdf")), "file", "input.pdf" }, { new StringContent("5"), "page" }, }; var response = await client.PostAsync( "https://api.pdfblocks.com/v1/split_at_page", form); response.EnsureSuccessStatusCode(); using var json = JsonDocument.Parse( await response.Content.ReadAsStringAsync()); foreach (var document in json.RootElement.GetProperty("documents").EnumerateArray()) { var name = document.GetProperty("name").GetString()!; var content = document.GetProperty("content").GetString()!; await File.WriteAllBytesAsync(name, Convert.FromBase64String(content)); } ``` ## Acciones relacionadas Divida en partes de tamaño fijo. Limite cada parte por tamaño en bytes. Conserve solo una parte del documento. Defina a mano grupos de páginas arbitrarios.