PDF Splitting

PDF Splitting
Split an uploaded PDF into smaller documents based on the requested page size and packaging options.

Method: POST
Path: /v1/imagerecognition/pdf-splitter
Demo: https://api.gugudata.io/v1/imagerecognition/pdf-splitter/demo
OpenAPI: https://gugudata.io/assets/openapi/gugudata.openapi.3.1.json

Request Parameters:

• appkey (string, required): Application key used for request authentication. Supply the value as a query parameter, form field, or multipart field according to the request content type.
• page_size (integer, required): Number of pages per split output file.
• is_zip (boolean, required): Whether the split PDF output should be packaged as a ZIP archive.
• file (file, required): Local file uploaded as multipart form data.

Response Fields:

• dataStatus.statusCode (integer, required): Application-level status code returned by the current v1 contract.
• dataStatus.status (string, required): Application-level status enum returned by the current v1 contract.
• dataStatus.statusDescription (string, required): Application-level status message returned by the current v1 contract.
• dataStatus.responseDateTime (string, required): Response timestamp returned by the current service contract.
• dataStatus.dataTotalCount (integer, required): Total number of records that match the request.
• data.uuid (string, required): Unique identifier for the split operation
• data.num_files (integer, required): Number of files generated after splitting
• data.pdf_files (array, required): Array of URLs to download the split PDF files or ZIP archive

HTTP Status Codes:

• 200: Request processed successfully. Some endpoints expose a separate application-level status field in the response body, such as dataStatus.statusCode.
• 400: Invalid request parameters or request format. Check required fields, data types, and request body format.
• 401: Missing or unknown application key. Provide a valid appkey with the request.
• 403: The application key is recognized but access is not allowed. The key may be expired, inactive, or not permitted for the requested API.
• 429: Request rate or trial usage limit exceeded. Reduce concurrency or retry after the limit window resets.
• 500: Internal service error. Retry later or contact support if the error persists.
• 503: Upstream service unavailable. Retry later; the requested upstream dependency is temporarily unavailable.

Business Status Codes:

• 200 Success: Operation completed successfully
• 400 Parameter error: Invalid or missing required parameters
• 401 Invalid APPKEY: Please check if the APPKEY is valid and active
• 429 Rate limit exceeded: Too many requests in a given time window
• 500 Server error: Internal server error occurred

Key Features:

• Split PDF files into smaller documents with customizable page size.
• Optional ZIP compression for multiple output files.
• Fast processing with cloud-based infrastructure.
• Secure file handling with HTTPS support.
• Distributed CDN for fast file delivery.
• Support for large PDF files.
• Automatic file cleanup after processing.
• RESTful API with JSON responses.

Details:
https://gugudata.io/details/pdf-splitter