PDF API

Macaaw PDF API

PDF API για συμπίεση, μετατροπή και υπογραφή

Ένα REST API για 22 εργαλεία PDF και ηλεκτρονικές υπογραφές. Κάθε εργασία εκτελείται στους διακομιστές μας στο Λονδίνο και τα αρχεία διαγράφονται μέσα σε 2 ώρες.

Αποκτήστε δωρεάν κλειδί δοκιμαστικού περιβάλλοντοςΔιαβάστε την τεκμηρίωση του API

  • OpenAPI 3.1
  • Συλλογή Postman
  • Δωρεάν δοκιμαστικό περιβάλλον
  • Υπογεγραμμένα webhook
Συμπίεση ενός PDF με ένα αίτημα
Γλώσσα δείγματος κώδικα
curl https://macaaw.com/public/v1/tasks \
  -H "Authorization: API-Key $MACAAW_API_KEY" \
  -F "files[]=@lease.pdf" \
  -F 'data={"tool":"compress-pdf","options":{"level":"recommended"}}'

# 201 Created
{ "id": "…", "tool": "compress-pdf", "status": "task.queued" }
// Node 18+ (fetch, FormData and Blob are built in)
import { readFile } from "node:fs/promises";

const form = new FormData();
form.append("files[]", new Blob([await readFile("lease.pdf")]), "lease.pdf");
form.append("data", JSON.stringify({ tool: "compress-pdf", options: { level: "recommended" } }));

const res = await fetch("https://macaaw.com/public/v1/tasks", {
  method: "POST",
  headers: { Authorization: `API-Key ${process.env.MACAAW_API_KEY}` },
  body: form,
});
const task = await res.json(); // { id, tool, status: "task.queued" }
# Python 3 with requests
import json, os, requests

res = requests.post(
    "https://macaaw.com/public/v1/tasks",
    headers={"Authorization": f"API-Key {os.environ['MACAAW_API_KEY']}"},
    files={"files[]": open("lease.pdf", "rb")},
    data={"data": json.dumps({"tool": "compress-pdf", "options": {"level": "recommended"}})},
)
task = res.json()  # {"id": ..., "status": "task.queued"}
  • 22Εργαλεία PDF σε ένα τελικό σημείο
  • 1 κλήσηγια ανέβασμα και έναρξη εργασίας
  • < 2 hμέχρι να διαγραφούν τα αρχεία σας
  • 0 £για το δοκιμαστικό περιβάλλον

Τι μπορείτε να δημιουργήσετε

Οι εργασίες PDF που το προϊόν σας δεν χρειάζεται να αναλαμβάνει

  • Μικρύνετε τα ανεβάσματα πριν τα αποθηκεύσετε

    Συμπιέστε PDF ή προσαρμόστε τα σε ακριβές μέγεθος τη στιγμή που τα ανεβάζουν οι χρήστες σας.

  • Μετατροπή αρχείων Office σε PDF

    Word, Excel, PowerPoint, OpenDocument και HTML σε PDF, με διατάξεις που διατηρούνται.

  • Κάντε τις σαρώσεις αναζητήσιμες

    Αναγνώριση κειμένου σε 32 γλώσσες, PDF/A για αρχειοθέτηση και πίνακες απευθείας σε Excel.

  • Στείλτε συμφωνίες από τη δική σας εφαρμογή

    Δημιουργήστε ένα έγγραφο από ένα PDF, τοποθετήστε πεδία με ετικέτες κειμένου, στείλτε το και κατεβάστε το υπογεγραμμένο αντίγραφο.

  • Ενσωματώστε την υπογραφή στο προϊόν σας

    Ανοίξτε μια συνεδρία υπογραφής μέσα στον ιστότοπό σας, περιορισμένη στις προελεύσεις που επιτρέπετε.

  • Εκτελέστε παρτίδες με webhook

    Ξεκινήστε εκατοντάδες εργασίες και λάβετε υπογεγραμμένη ειδοποίηση καθώς ολοκληρώνεται η καθεμία.

  • Κλειδιά με εύρος και παρτίδες

    Κλειδιά με εύρος δικαιωμάτων και εναλλαγή, εργασίες σε παρτίδες, πρόοδος σε πραγματικό χρόνο και προβολές σελίδων.

  • Ενσωματωμένοι επεξεργαστές

    Βάλτε τον επεξεργαστή PDF ή τον επεξεργαστή εικόνων μέσα στη δική σας εφαρμογή, δίπλα στην ενσωματωμένη υπογραφή.

Πώς λειτουργεί

Από το κλειδί στο αποτέλεσμα με τέσσερις κλήσεις

  1. Δημιουργία κλειδιού

    Δημιουργήστε ένα κλειδί δοκιμαστικού περιβάλλοντος στον λογαριασμό σας. Μεταβείτε σε κλειδί παραγωγής όταν είστε έτοιμοι.

    Λογαριασμός › Προγραμματιστές
  2. Έναρξη εργασίας

    Στείλτε τα αρχεία και το εργαλείο σε ένα αίτημα multipart.

    POST /public/v1/tasks
  3. Μάθετε πότε ολοκληρώθηκε

    Εγγραφείτε στο task_completed ή ελέγχετε περιοδικά την εργασία.

    webhook: task_completed
  4. Λήψη

    Λάβετε το αποτέλεσμα και έπειτα διαγράψτε το ή αφήστε το να λήξει.

    GET /tasks/{id}/download

Τελικά σημεία

Ένα μικρό, προβλέψιμο API

Βασικό URL https://macaaw.com/public/v1 · JSON με κλειδιά snake_case · Authorization: API-Key …

Πλήρης αναφορά API

Εργασίες · εργαλεία PDF

  • GET/toolsΚάθε εργαλείο που μπορείτε να καλέσετε, με τις επιλογές του
  • POST/tasksΑνεβάστε αρχεία και ξεκινήστε ένα εργαλείο με μία κλήση
  • GET/tasks/{id}Κατάσταση: σε αναμονή, σε επεξεργασία, ολοκληρώθηκε ή απέτυχε
  • GET/tasks/{id}/downloadΤο αρχείο αποτελέσματος ή ένα ZIP
  • DELETE/tasks/{id}Διαγραφή των αρχείων τώρα

Έγγραφα · ηλεκτρονικές υπογραφές

  • POST/documentsΈνα PDF μαζί με παραλήπτες και πεδία ή ετικέτες κειμένου
  • POST/documents/{id}/sendΑποστολή με email ή αθόρυβα για ενσωματωμένη υπογραφή
  • GET/documents/{id}/detailsΠαραλήπτες, πεδία και το πλήρες χρονολόγιο
  • POST/documents/{id}/sessionΈνας σύνδεσμος υπογραφής για τη δική σας σελίδα
  • GET/documents/{id}/downloadΤο υπογεγραμμένο PDF με το πιστοποιητικό του

Webhook

  • POST/webhook-subscriptionsΕπιλέξτε εναύσματα όπως task_completed ή document_state_changed
  • GET/webhook-eventsΙστορικό παραδόσεων, με επανάληψη αποστολής

Ασφάλεια

Φτιαγμένο για παραγωγή από την πρώτη μέρα

Οι ίδιοι κανόνες διαγραφής και η ίδια επεξεργασία στο Ηνωμένο Βασίλειο με τον ιστότοπο, καθώς και οι έλεγχοι που περιμένει μια ομάδα μηχανικών.

  • Κλειδιά που ελέγχετε εσείςΚλειδιά παραγωγής και δοκιμαστικού περιβάλλοντος, που εμφανίζονται μία φορά και αποθηκεύονται ως hash. Ανακαλέστε οποιοδήποτε κλειδί από τον λογαριασμό σας.
  • Υπογεγραμμένα webhookΚάθε παράδοση φέρει ?signature= με ένα HMAC-SHA256 του σώματος, δημιουργημένο με το κοινόχρηστο κλειδί σας.
  • Τα αρχεία διαγράφονται γρήγοραΤα αρχεία εργασιών διατηρούνται 1 ώρα σε δωρεάν λογαριασμό και 2 ώρες στα Pro και Business και έπειτα εξαφανίζονται. Το DELETE τα αφαιρεί αμέσως.
  • Επεξεργασία στο Ηνωμένο ΒασίλειοΚάθε εργασία εκτελείται στους διακομιστές μας στο Λονδίνο. Τα αρχεία καταγραφής αιτημάτων δεν αποθηκεύουν ποτέ περιεχόμενο ή ονόματα αρχείων.
  • Δίκαια όρια ρυθμού120 νέες εργασίες το λεπτό ανά χρήστη, με Retry-After σε κάθε 429.
  • Ασφαλείς επαναλήψειςΣτείλτε ένα Idempotency-Key και ένα επαναλαμβανόμενο αίτημα επιστρέφει το πρώτο αποτέλεσμα για 24 ώρες.

Τιμές

Ξεκινήστε δωρεάν. Πληρώνετε καθώς μεγαλώνετε.

Δοκιμαστικό περιβάλλον

0 £

  • Κάθε τελικό σημείο, με δοκιμαστικά δεδομένα
  • 10 αιτήματα το λεπτό
  • Έως 5 σελίδες ανά εργασία
  • Αποτελέσματα με σήμανση «Sandbox»
  • Τα δοκιμαστικά δεδομένα διαγράφονται μετά από 7 ημέρες
Αποκτήστε κλειδί δοκιμαστικού περιβάλλοντος

Παραγωγή, στο Pro ή στο Business

Από 4,99 £τον μήνα, με ετήσια χρέωση

  • Χρησιμοποιεί τα μηνιαία όρια του προγράμματός σας
  • Έπειτα μονάδες: από 5 £ για 500
  • 1 μονάδα ανά σελίδα OCR, 2 μονάδες ανά μετατροπή Office
  • 120 νέες εργασίες το λεπτό
Σύγκριση προγραμμάτων

Enterprise

Τιμολόγηση όγκου

  • Τιμολόγηση όγκου για σελίδες και μετατροπές
  • Προσαρμοσμένα όρια, με σύμβαση
  • Ετήσια τιμολόγηση
  • Συγκεκριμένο άτομο επικοινωνίας
Μιλήστε μαζί μας

Ερωτήσεις

Οι προγραμματιστές ρωτούν

Υπάρχει δωρεάν τρόπος να δοκιμάσω το API;

Ναι. Οποιοσδήποτε συνδεδεμένος χρήστης μπορεί να δημιουργήσει δωρεάν κλειδί δοκιμαστικού περιβάλλοντος. Οι κλήσεις στο δοκιμαστικό περιβάλλον περιορίζονται σε 10 το λεπτό και 5 σελίδες ανά εργασία, κάθε αποτέλεσμα φέρει τη σήμανση «Sandbox» και τα δοκιμαστικά δεδομένα διαγράφονται μετά από 7 ημέρες.

Ποια εργαλεία μπορώ να καλέσω;

Τα 22 εργαλεία που λειτουργούν στους διακομιστές μας, από τη Συμπίεση και το OCR έως τις μετατροπές Office και το PDF/A, καθώς και οι ηλεκτρονικές υπογραφές. Το GET /tools τα εμφανίζει με τις επιλογές τους. Τα 33 εργαλεία προγράμματος περιήγησης λειτουργούν στα προγράμματα περιήγησης των χρηστών σας, οπότε δεν περιλαμβάνονται στο API v1.

Πώς χρεώνεται η χρήση του API;

Τα κλειδιά παραγωγής περιλαμβάνονται στα Pro και Business. Οι κλήσεις χρησιμοποιούν τα ίδια μηνιαία όρια με τον ιστότοπο· πέρα από αυτά, ισχύουν μονάδες. Τα πακέτα μονάδων ξεκινούν από 5 £ για 500 μονάδες και διαρκούν 12 μήνες.

Έχετε SDK;

Η τεκμηρίωση έχει δείγματα για αντιγραφή και επικόλληση σε curl, Node και Python για κάθε τελικό σημείο, ένα αρχείο OpenAPI 3.1 και μια συλλογή Postman, ώστε να μπορείτε να δημιουργήσετε client σε οποιαδήποτε γλώσσα.

Τι γίνεται αν το τελικό σημείο του webhook μου δεν λειτουργεί;

Επαναλαμβάνουμε τρεις ακόμα φορές, μετά από 1 λεπτό, 10 λεπτά και 1 ώρα, και έπειτα σημειώνουμε την παράδοση ως αποτυχημένη. Μπορείτε να τη στείλετε ξανά από τον λογαριασμό σας ή με το API.

Προσθέστε λειτουργίες PDF αυτή την εβδομάδα.

Δημιουργήστε κλειδί δοκιμαστικού περιβάλλοντος σε ένα λεπτό. Δεν χρειάζεται κάρτα.