Set Page Label
You can set page labels of a document using the setPageLabel
operation. This can be useful when, for example, you want PDF readers to show Roman numerals for page labels instead of Arabic numerals.
Before you get started, make sure that Processor is up and running.
Setting the Page Label of the File on Disk
Send a request to the /process
endpoint, attaching an input file and the operations JSON:
curl -X POST http://localhost:5000/process \ -F file=@/path/to/example.pdf \ -F operations='{ "operations": [ { "type": "setPageLabel", "pageIndexes": [ 0 ], "pageLabel": "i" } ] }' \ -o result.pdf
POST /process HTTP/1.1 Content-Type: multipart/form-data; boundary=customboundary --customboundary Content-Disposition: form-data; name="file"; filename="example.pdf" Content-Type: application/pdf <PDF data> --customboundary Content-Disposition: form-data; name="operations" Content-Type: application/json { "operations": [ { "type": "setPageLabel", "pageIndexes": [ 0 ], "pageLabel": "i" } ] } --customboundary--
This will set the page label of the first page to “i.” You can see this by opening the resulting PDF in a PDF viewer application:
Setting the Page Label of the File from a URL
Send a request to the /process
endpoint, attaching a URL pointing to an input file and the operations JSON:
curl -X POST http://localhost:5000/process \ -F url=https://pspdfkit.com/downloads/examples/paper.pdf \ -F operations='{ "operations": [ { "type": "setPageLabel", "pageIndexes": [ 0 ], "pageLabel": "i" } ] }' \ -o result.pdf
POST /process HTTP/1.1 Content-Type: multipart/form-data; boundary=customboundary --customboundary Content-Disposition: form-data; name="url" https://pspdfkit.com/downloads/examples/paper.pdf --customboundary Content-Disposition: form-data; name="operations" Content-Type: application/json { "operations": [ { "type": "setPageLabel", "pageIndexes": [ 0 ], "pageLabel": "i" } ] } --customboundary--
This will set the page label of the first page to “i.”