Ίδια λειτουργία, τέσσερις πελάτες: φυλλομετρητής, curl, MCP, pdfx
Η ίδια συγχώνευση PDF123 από τέσσερις πελάτες: τη φόρμα του φυλλομετρητή, το curl στο /api/v1/general/merge-pdfs, το MCP στο /mcp και το pdfx τοπικά ή --cloud.
Τέσσερις πελάτες μοιάζουν με τέσσερα προϊόντα. Μοιράζονται έναν κατάλογο. Πάρτε τη Συγχώνευση ως συγκεκριμένη εργασία: συνδυάζει 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
Τοπικό pdf-core:
pdfx merge a.pdf b.pdf -o merged.pdf
Ή τον ίδιο διακομιστή που χρησιμοποιεί η πύλη:
pdfx --cloud --api-base "$API_BASE" --api-key "$KEY" merge a.pdf b.pdf -o merged.pdf
Η τοπική λειτουργία δεν μεταφορτώνει ποτέ· η λειτουργία νέφους χτυπά τη βάση σας με το ίδιο σχήμα multipart όπως το curl. Η δεξιότητα για πράκτορες προγραμματισμού στο dist/skills/pdf-toolbox/SKILL.md τεκμηριώνει τα ίδια σχήματα συγχώνευσης και αγωγών, ώστε οι πράκτορες να μην επινοούν δεύτερο OpenAPI.
Το OCR μέσα από οποιονδήποτε από αυτούς τους πελάτες επιστρέφει πάλι Markdown από το /api/v1/misc/ocr-pdf, όχι κρυφό στρώμα κειμένου. Αυτό το γεγονός είναι μέρος του κοινού συμβολαίου: η αλλαγή του τύπου επιστροφής σε έναν πελάτη χωρίς τους άλλους θα έσπαγε την υπόσχεση της «ίδιας λειτουργίας». Η Συμπίεση μένει στο /api/v1/misc/compress-pdf για επανασυμπίεση ροών· είναι διαφορετική λειτουργία από τη συγχώνευση, προσβάσιμη με τους ίδιους τέσσερις τρόπους.
Γιατί μετρά η ταυτότητα
Αν η συγχώνευση στον φυλλομετρητή και η συγχώνευση στο API απέκλιναν ποτέ, οι αυτοματοποιήσεις θα υποβαθμίζονταν σιωπηλά ενώ η σελίδα επίδειξης θα φαινόταν ακόμη εντάξει. Μία λειτουργία, τέσσερις λαβές, αυτό είναι το νόημα. Η πύλη είναι πελάτης ευκολίας, όχι δεύτερη υλοποίηση της συγχώνευσης, της συμπίεσης ή του OCR.
Γι' αυτό άλλωστε δεν υπάρχει έκδοση για υπολογιστή: ένα πέμπτο δέντρο διεπαφής θα επανέφερε το πρόβλημα της απόκλισης κάτω από διαφορετικό όνομα εκτελέσιμου. Ευρύτερο πλαίσιο: Φτιαγμένο για πράκτορες AI, όχι μόνο για φυλλομετρητές. Για την απόφαση περί υπολογιστή, δείτε το Γιατί παραλείψαμε την εφαρμογή για υπολογιστή. Για το στήσιμο του API στο δίκτυό σας, δείτε την Αυτο-φιλοξενία.