Wysłanie tylko części stron pliku PDF: Wyodrębnij strony, Usuń strony i co zostaje w pliku

Wyodrębnij strony zamienia 12-stronicowy plik PDF w nowy plik zawierający tylko wskazane strony, na przykład 1,3,5-8. Usuń strony działa odwrotnie: wypisujesz to, co ma zniknąć. Oba narzędzia kopiują oryginalne strony zamiast rysować je od nowa, więc tekst nadal da się zaznaczyć, a plik się nie rozmywa. Jedno ograniczenie ma znaczenie, gdy usunięte strony były poufne: treść stron znika, ale tytuły zakładek i tytuł dokumentu mogą zostać w nowym pliku.

Wybierz narzędzie według tego, co już wiesz

Jeśli znasz strony do zachowania, użyj Wyodrębnij strony. Jeśli znasz strony do usunięcia, użyj Usuń strony. Różnicę widać w kolejności wyniku:

• Wyodrębnij strony zapisuje strony w kolejności, w jakiej je wpiszesz. Wpisanie 5,1,3 daje stronę 5, potem 1, potem 3. Strona wpisana dwa razy pojawia się raz.
• Usuń strony zachowuje pozostałe strony w ich pierwotnej kolejności.

Numery stron to te, które pokazuje przeglądarka PDF, licząc od 1. W obu narzędziach działa ta sama składnia listy: pojedyncze strony (4), zakresy (5-8), listy rozdzielane przecinkami (1,3,5-8), słowo all oraz wyrażenia takie jak 2n+1. Wyrażenie liczy n od 1, więc 2n+1 daje strony 3, 5, 7 i tak dalej; strona 1 nie jest wliczona, więc wpisz 1,2n+1, jeśli ma się znaleźć w wyniku.

Przykład krok po kroku: wysłanie wynajmującemu części umowy najmu

Dane wejściowe to 12-stronicowa umowa najmu w formacie Letter. Każda strona ma własny numer jako tekst („Lease agreement - page 3 of 12”), więc wynik łatwo sprawdzić. Wynajmujący potrzebuje stron 1, 3 oraz 5-8, bez załącznika. W przeglądarce wgrywasz plik, wpisujesz 1,3,5-8 i pobierasz wynik. Ze skryptu ta sama operacja wygląda tak:

curl -s -o pages.pdf \
  -F [email protected] \
  -F pageNumbers="1,3,5-8" \
  https://pdf123.xyz/api/v1/general/rearrange-pages

Narzędzie na stronie wysyła listę do tego punktu końcowego i zostawia customMode nieustawione, co oznacza „użyj mojej listy w mojej kolejności”. Poniżej wyniki jednego przebiegu na lokalnym serwerze z 2026-10-04, na wygenerowanym pliku testowym; liczby to liczby stron i etykiety stron odczytane z wyniku:

Pobrany plik zachowuje nazwę wgranego pliku, więc zmień ją przed wysłaniem, bo inaczej na dysku będziesz mieć dwa pliki lease.pdf.

Trzy dane wejściowe, które kończą się błędem, i co mówi komunikat

Strona, która nie istnieje, to błąd, a nie ciche pominięcie. Prośba o stronę 13 w 12-stronicowym pliku zwraca 400 (page_out_of_range) z komunikatem Page 13 does not exist; the document has 12 pages. Strona 0 jest odrzucana tak samo. Tekst, który nie jest listą stron, na przykład abc, zwraca 400 z invalid_page_selection i wskazówką, by użyć wartości takich jak 1,3,5-8 lub all. Oba narzędzia zachowują się tu tak samo, więc literówka nie wyprodukuje wiarygodnego, ale błędnego pliku.

Dwa przypadki brzegowe są mniej oczywiste. Zakres, który zaczyna się wewnątrz dokumentu, a kończy poza nim, jest przycinany: 10-15 przy 12 stronach dało strony od 10 do 12. A Usuń strony odmawia usunięcia wszystkiego: 1-12 zwraca 400 (would remove every page, which leaves nothing to return), ponieważ plik PDF bez stron nie może istnieć.

Plik chroniony hasłem wymaga podania hasła na stronie. Jeśli wywołujesz API bezpośrednio, najpierw użyj narzędzia Usuń hasło.

Co zostaje w pliku: usunięcie strony to nie zaczernienie

Wyodrębnianie odrzuca obiekty stron, a wraz z nimi tekst i obrazy stron, których nie wskazałeś. W teście wyodrębniony plik nie zawierał tekstu z usuniętych stron. Nie odrzucił jednak wszystkiego, co o nich wspomina. Bajty zachowanych stron w moim pliku testowym również nie zawierały śladu usuniętego tekstu.

Do tego sprawdzenia umowa miała tytuł dokumentu („Lease - Unit 4B, J. Rivera”) i dwie zakładki: „Signature page” na stronie 1 i „Tenant SSN appendix” na stronie 12. Po tym, jak Wyodrębnij strony zostawiło strony 1 i 2, plik miał 2 strony, a panel zakładek w przeglądarce nadal wyświetlał oba tytuły; drugi wskazywał teraz donikąd. Tytuł i autor nadal były we właściwościach dokumentu. Usuń strony dla strony 12 zostawiło te same dwie zakładki.

Oczyść PDF z włączonymi opcjami metadanych czyści informacje o dokumencie i metadane XMP, a właściwości dokumentu po tym wróciły puste. Formularz na stronie domyślnie włącza te opcje; wywołanie API musi samo wysłać removeMetadata=true. Oczyść PDF nie dotyka zakładek: oba tytuły nadal tam były. Żadne narzędzie na stronie nie edytuje zakładek. Operacja API general/edit-table-of-contents zastępuje je listą JSON i wymaga co najmniej jednego wpisu, więc nie da się nią po prostu opróżnić listy. W teście zostawiła też stary tekst tytułu w pliku jako nieodwołany obiekt, niewidoczny w przeglądarce, ale wciąż czytelny w surowych bajtach. Nie licz na to, że ukryje tytuł zakładki.

Dlatego gdy usunięte strony były poufne, otwórz wynik, zajrzyj do panelu zakładek i właściwości dokumentu i wysyłaj tylko wtedy, gdy nic w nich nie zdradza treści. Jeśli sekretem jest sam tytuł zakładki, ta droga go nie usunie. Jeśli widoczne słowo na zachowanej stronie musi zniknąć, to zadanie dla Zaciemnij tekst, opisanego w Zanim udostępnisz.

Koszty i ograniczenia

• Oba narzędzia pracują na jednym pliku PDF naraz i tworzą jeden plik PDF. Pocięcie pliku na kilka części to zadanie dla Podziel PDF.
• Wynik to nowy plik, a oryginał pozostaje nietknięty. Zachowaj oryginał, bo nowy plik nie przywróci usuniętych stron.
• Plik, który w ogóle się nie otwiera, wymaga najpierw Napraw PDF; zobacz Plik się nie otwiera.