Product3 λεπ. ανάγνωση

Ίδια λειτουργία, τέσσερις πελάτες: φυλλομετρητής, curl, MCP, pdfx

Η ίδια συγχώνευση PDF123 από τέσσερις πελάτες: η φόρμα του φυλλομετρητή, curl στο /api/v1/general/merge-pdfs, MCP στο /mcp και το CLI pdfx απέναντι στη βάση του API σας.

By the PDF123 team · Updated 2026-09-29
Ίδια λειτουργία, τέσσερις πελάτες: φυλλομετρητής, curl, MCP, pdfx

Τέσσερις πελάτες μοιάζουν με τέσσερα προϊόντα. Μοιράζονται έναν κατάλογο. Πάρτε τη Συγχώνευση ως συγκεκριμένη εργασία: συνδυάζει PDF με τη σειρά μεταφόρτωσης χωρίς να ραστεροποιεί τις σελίδες σε εικόνες. Το ίδιο μοτίβο ισχύει για κάθε άλλο εργαλείο του καταλόγου (συμπίεση, OCR, μετατροπή και τα υπόλοιπα): ένα αναγνωριστικό λειτουργίας, τέσσερις τρόποι να την καλέσετε.

Φυλλομετρητής

Ανοίξτε το /merge, προσθέστε αρχεία με τη σειρά που θέλετε, πατήστε «Επεξεργασία», κατεβάστε. Χωρίς λογαριασμό για τα εργαλεία του καταλόγου. Το μπλοκ «Κλήση από κώδικα» της σελίδας χτίζει curl από τα ίδια πεδία που στέλνει η φόρμα, ώστε η διεπαφή και το συμβόλαιο HTTP να μένουν ευθυγραμμισμένα.

Αυτό το μπλοκ δεν είναι διαφημιστικό κείμενο. Παράγεται από τον ορισμό του εργαλείου που χρησιμοποιεί ήδη η πύλη για τη φόρμα, γι' αυτό η μετονομασία μιας παραμέτρου εμφανίζεται μαζί και στα δύο σημεία. Αν η φόρμα δέχεται την προαιρετική παράμετρο sortType=byFileName, το παράδειγμα curl μπορεί να φέρει το ίδιο πεδίο.

curl / REST

curl -fsS -X POST "$API_BASE/api/v1/general/merge-pdfs" \
  -F "[email protected]" \
  -F "[email protected]" \
  -o merged.pdf

Οι ανώνυμες κλήσεις στον κατάλογο δεν χρειάζονται κλειδί. Τα κλειδιά από τη σελίδα Προγραμματιστές δίνουν στην αυτοματοποίηση σταθερή ταυτότητα (και στους αυτο-φιλοξενούμενους διακομιστές μια πύλη). Το OpenAPI βρίσκεται στο /v1/openapi.json.

Για πολυβηματικές εργασίες, το POST /api/v1/pipeline δέχεται διατεταγμένες λειτουργίες σε πεδίο steps (για παράδειγμα συγχώνευση, μετά υδατογράφημα, μετά συμπίεση). Στείλτε Idempotency-Key όταν οι επαναλήψεις δεν πρέπει να εκτελέσουν δύο φορές την εργασία· μια επιτυχημένη επανάληψη μπορεί να επιστρέψει με Idempotency-Replayed. Οι αποτυχίες χρησιμοποιούν application/problem+json με σταθερούς κωδικούς όπως rate_limited και bad_request (Σφάλματα για προγραμματιστές).

Οι φιλοξενούμενες απαντήσεις ανακοινώνουν επίσης X-RateLimit-Limit, X-RateLimit-Remaining και X-RateLimit-Reset· το HTTP 429 περιλαμβάνει Retry-After. Αντιμετωπίστε αυτές τις κεφαλίδες ως ζωντανό προϋπολογισμό, όχι ως αριθμό απομνημονευμένο από άρθρο (ανώνυμος περιορισμός ρυθμού).

MCP

Οι πράκτορες που μιλούν το Model Context Protocol συνδέονται στο /mcp, ανακαλύπτουν τη συγχώνευση ως εργαλείο και την καλούν με την ίδια ιστορία κλειδιού API όπως το REST. Τεκμηρίωση: MCP για προγραμματιστές.

Το MCP δεν είναι δεύτερος κατάλογος. Είναι πρωτόκολλο ανακάλυψης και κλήσης πάνω στις ίδιες λειτουργίες που απαριθμεί το OpenAPI. Αν μια λειτουργία λείπει από το MCP, αυτό είναι σφάλμα του διακομιστή, όχι ξεχωριστός οδικός χάρτης προϊόντος. Συνδυάστε το MCP με το /llms.txt όταν θέλετε ευρετήριο εργαλείων σε πεζό λόγο πριν συνδεθεί ο πελάτης.

CLI pdfx

pdfx --api-base "$API_BASE" --api-key "$KEY" merge a.pdf b.pdf -o merged.pdf

Το ίδιο σχήμα multipart με το παραπάνω curl, με τη βάση του API να έχει προεπιλογή τη φιλοξενούμενη. Αυτό που προσθέτει το CLI είναι εργονομία κελύφους: το -o δέχεται κατάλογο και δεν αντικαθιστά ποτέ υπάρχον αρχείο, πολλές είσοδοι εκτελούνται ως παρτίδα με το --concurrency, και μια παρτίδα αναφέρει μία γραμμή input -> saved ανά αρχείο, με τις αποτυχίες στο stderr ενώ τα υπόλοιπα ολοκληρώνονται. Τα pdfx list και pdfx describe <tool> διαβάζουν τον κατάλογο που αποδίδει η πύλη, και η δημοσιευμένη δεξιότητα στο /skills/pdf123.md τεκμηριώνει τα ίδια σχήματα συγχώνευσης και αγωγού, ώστε οι πράκτορες να μην επινοήσουν δεύτερο OpenAPI.

Το OCR μέσα από οποιονδήποτε από αυτούς τους πελάτες επιστρέφει πάλι Markdown από το /api/v1/misc/ocr-pdf, όχι κρυφό στρώμα κειμένου. Αυτό το γεγονός είναι μέρος του κοινού συμβολαίου: η αλλαγή του τύπου επιστροφής σε έναν πελάτη χωρίς τους άλλους θα έσπαγε την υπόσχεση της «ίδιας λειτουργίας». Η Συμπίεση μένει στο /api/v1/misc/compress-pdf για επανασυμπίεση ροών· είναι διαφορετική λειτουργία από τη συγχώνευση, προσβάσιμη με τους ίδιους τέσσερις τρόπους.

Γιατί μετρά η ταυτότητα

Αν η συγχώνευση στον φυλλομετρητή και η συγχώνευση στο API απέκλιναν ποτέ, οι αυτοματοποιήσεις θα υποβαθμίζονταν σιωπηλά ενώ η σελίδα επίδειξης θα φαινόταν ακόμη εντάξει. Μία λειτουργία, τέσσερις λαβές, αυτό είναι το νόημα. Η πύλη είναι πελάτης ευκολίας, όχι δεύτερη υλοποίηση της συγχώνευσης, της συμπίεσης ή του OCR.

Γι' αυτό άλλωστε δεν υπάρχει έκδοση για υπολογιστή: ένα πέμπτο δέντρο διεπαφής θα επανέφερε το πρόβλημα της απόκλισης κάτω από διαφορετικό όνομα εκτελέσιμου. Ευρύτερο πλαίσιο: Φτιαγμένο για πράκτορες AI, όχι μόνο για φυλλομετρητές. Για την απόφαση περί υπολογιστή, δείτε το Γιατί παραλείψαμε την εφαρμογή για υπολογιστή. Για το στήσιμο του API στο δίκτυό σας, δείτε την Αυτο-φιλοξενία.

Open tool
Process in the browser — no watermark, files removed after the job.
Open tool