Macaaw PDF API
కంప్రెస్, మార్పిడి, సంతకం కోసం PDF API
20 PDF టూల్స్, ఇ-సంతకాల కోసం ఒకే REST API. ప్రతి పని లండన్లోని మా సర్వర్లలో నడుస్తుంది, ఫైళ్లు 2 గంటల్లో తొలగించబడతాయి.
ఉచిత శాండ్బాక్స్ కీని పొందండిAPI డాక్యుమెంటేషన్ చదవండి
- OpenAPI 3.1
- Postman కలెక్షన్
- ఉచిత శాండ్బాక్స్
- సంతకం చేసిన వెబ్హుక్లు
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"}- 20ఒకే ఎండ్పాయింట్లో PDF టూల్స్
- 1 కాల్అప్లోడ్ చేసి పనిని ప్రారంభించడానికి
- < 2 hమీ ఫైళ్లు తొలగించబడే వరకు
- £0శాండ్బాక్స్ కోసం
మీరు ఏమి నిర్మించవచ్చు
మీ ఉత్పత్తి స్వయంగా చూసుకోనవసరం లేని PDF పనులు
నిల్వ చేసే ముందు అప్లోడ్లను తగ్గించండి
మీ వినియోగదారులు అప్లోడ్ చేసిన క్షణంలోనే PDF లను కంప్రెస్ చేయండి, లేదా ఖచ్చితమైన పరిమాణం లోపలికి తీసుకురండి.
Office ఫైళ్లను PDF గా మార్చండి
Word, Excel, PowerPoint, OpenDocument, HTML నుండి PDF కు, లేఅవుట్లు చెదరకుండా.
స్కాన్లను శోధించదగినవిగా చేయండి
27 భాషలలో టెక్స్ట్ గుర్తింపు, ఆర్కైవ్ల కోసం PDF/A, పట్టికలు నేరుగా Excel కు.
మీ సొంత యాప్ నుండి ఒప్పందాలను పంపండి
PDF నుండి పత్రాన్ని సృష్టించండి, టెక్స్ట్ ట్యాగ్లతో ఫీల్డ్లను ఉంచండి, పంపండి, సంతకం చేసిన కాపీని డౌన్లోడ్ చేయండి.
సంతకాన్ని మీ ఉత్పత్తిలో పొందుపరచండి
మీరు అనుమతించిన ఆరిజిన్లకు పరిమితమై, మీ సైట్ లోపలే సంతకం సెషన్ను తెరవండి.
వెబ్హుక్లతో బ్యాచ్లను నడపండి
వందలాది పనులను ప్రారంభించండి, ప్రతిదీ పూర్తయినప్పుడు సంతకం చేసిన కాల్బ్యాక్ పొందండి.
ఇది ఎలా పని చేస్తుంది
కీ నుండి ఫలితం వరకు నాలుగు కాల్స్లో
కీని సృష్టించండి
మీ ఖాతాలో శాండ్బాక్స్ కీని తయారు చేయండి. సిద్ధమైనప్పుడు లైవ్ కీకి మారండి.
ఖాతా › డెవలపర్పనిని ప్రారంభించండి
ఒకే మల్టీపార్ట్ అభ్యర్థనలో ఫైళ్లను, టూల్ను పంపండి.
POST /public/v1/tasksపూర్తయినప్పుడు తెలుసుకోండి
task_completed కు సబ్స్క్రైబ్ చేయండి, లేదా పనిని పోల్ చేయండి.
webhook: task_completedడౌన్లోడ్
ఫలితాన్ని తీసుకోండి, ఆ తర్వాత తొలగించండి లేదా గడువు ముగియనివ్వండి.
GET /tasks/{id}/download
ఎండ్పాయింట్లు
చిన్న, ఊహించదగిన API
బేస్ URL https://macaaw.com/public/v1 · snake_case కీలతో JSON · Authorization: API-Key …
పనులు · PDF టూల్స్
- GET
/toolsమీరు కాల్ చేయగల ప్రతి టూల్, దాని ఎంపికలతో - POST
/tasksఒకే కాల్లో ఫైళ్లను అప్లోడ్ చేసి టూల్ను ప్రారంభించండి - GET
/tasks/{id}స్థితి: క్యూలో, ప్రాసెసింగ్, పూర్తయింది లేదా విఫలమైంది - GET
/tasks/{id}/downloadఫలిత ఫైల్, లేదా ZIP - DELETE
/tasks/{id}ఫైళ్లను ఇప్పుడే తొలగించండి
పత్రాలు · ఇ-సంతకాలు
- POST
/documentsPDF తో పాటు గ్రహీతలు, ఫీల్డ్లు, లేదా టెక్స్ట్ ట్యాగ్లు - POST
/documents/{id}/sendఇమెయిల్ ద్వారా పంపండి, లేదా పొందుపరిచిన సంతకం కోసం నిశ్శబ్దంగా - GET
/documents/{id}/detailsగ్రహీతలు, ఫీల్డ్లు, పూర్తి టైమ్లైన్ - POST
/documents/{id}/sessionమీ సొంత పేజీ కోసం సంతకం లింక్ - GET
/documents/{id}/downloadసర్టిఫికెట్తో సంతకం చేసిన PDF
వెబ్హుక్లు
- POST
/webhook-subscriptionstask_completed లేదా document_state_changed వంటి ట్రిగ్గర్లను ఎంచుకోండి - GET
/webhook-eventsడెలివరీ చరిత్ర, మళ్లీ పంపే సదుపాయంతో
భద్రత
మొదటి రోజు నుండే ప్రొడక్షన్ కోసం రూపొందించబడింది
వెబ్సైట్ లాగే అవే తొలగింపు నియమాలు, UK ప్రాసెసింగ్, అలాగే ఇంజినీరింగ్ టీమ్ ఆశించే నియంత్రణలు.
- మీ నియంత్రణలో ఉన్న కీలులైవ్, శాండ్బాక్స్ కీలు ఒక్కసారి మాత్రమే చూపబడతాయి, హ్యాష్గా నిల్వ చేయబడతాయి. మీ ఖాతా నుండి ఏ కీనైనా రద్దు చేయవచ్చు.
- సంతకం చేసిన వెబ్హుక్లుప్రతి డెలివరీ మీ షేర్డ్ కీతో తయారైన బాడీ యొక్క HMAC-SHA256 తో ?signature= ను కలిగి ఉంటుంది.
- ఫైళ్లు వేగంగా తొలగింపుపని ఫైళ్లు ఉచిత ఖాతాలో 1 గంట, Pro మరియు Business లో 2 గంటలు ఉంచబడతాయి, ఆ తర్వాత అవి పోతాయి. DELETE వాటిని వెంటనే తొలగిస్తుంది.
- UK లో ప్రాసెసింగ్ప్రతి పని లండన్లోని మా సర్వర్లలో నడుస్తుంది. అభ్యర్థన లాగ్లు ఫైల్ కంటెంట్ను లేదా ఫైల్ పేర్లను ఎప్పుడూ నిల్వ చేయవు.
- న్యాయమైన రేట్ పరిమితులుప్రతి వినియోగదారుకు నిమిషానికి 120 కొత్త పనులు, ప్రతి 429 పై Retry-After తో.
- సురక్షితమైన రీట్రైలుIdempotency-Key ను పంపండి, పునరావృత అభ్యర్థన 24 గంటల పాటు మొదటి ఫలితాన్నే ఇస్తుంది.
ధరలు
ఉచితంగా ప్రారంభించండి. ఎదిగే కొద్దీ చెల్లించండి.
శాండ్బాక్స్
£0
- టెస్ట్ డేటాతో ప్రతి ఎండ్పాయింట్
- నిమిషానికి 10 అభ్యర్థనలు
- ప్రతి పనికి 5 పేజీల వరకు
- అవుట్పుట్లపై “Sandbox” స్టాంప్
- టెస్ట్ డేటా 7 రోజుల తర్వాత తొలగింపు
లైవ్, Pro లేదా Business లో
£4.99 నుండినెలకు, వార్షికంగా బిల్ చేయబడుతుంది
- మీ ప్లాన్ నెలవారీ పరిమితులను వాడుతుంది
- ఆ తర్వాత క్రెడిట్లు: 500 కు £5 నుండి
- ప్రతి OCR పేజీకి 1 క్రెడిట్, ప్రతి Office మార్పిడికి 2 క్రెడిట్లు
- నిమిషానికి 120 కొత్త పనులు
Enterprise
వాల్యూమ్ ధరలు
- పేజీలు, మార్పిడులపై వాల్యూమ్ ధరలు
- ఒప్పందం ద్వారా విక్రయించే కస్టమ్ పరిమితులు
- వార్షిక ఇన్వాయిస్ బిల్లింగ్
- పేరున్న సంప్రదింపు వ్యక్తి
ప్రశ్నలు
డెవలపర్లు అడిగేవి
API ని ప్రయత్నించడానికి ఉచిత మార్గం ఉందా?
అవును. సైన్ ఇన్ అయిన ఏ వినియోగదారైనా ఉచితంగా శాండ్బాక్స్ కీని సృష్టించవచ్చు. శాండ్బాక్స్ కాల్స్ నిమిషానికి 10, ప్రతి పనికి 5 పేజీలకు పరిమితం, ప్రతి అవుట్పుట్పై “Sandbox” స్టాంప్ ఉంటుంది, టెస్ట్ డేటా 7 రోజుల తర్వాత తొలగించబడుతుంది.
నేను ఏ టూల్స్ను కాల్ చేయవచ్చు?
మా సర్వర్లలో నడిచే 20 టూల్స్, కంప్రెస్, OCR నుండి Office మార్పిడులు, PDF/A వరకు, అలాగే ఇ-సంతకాలు. GET /tools వాటిని ఎంపికలతో కలిపి జాబితా చేస్తుంది. 20 బ్రౌజర్ టూల్స్ మీ వినియోగదారుల బ్రౌజర్లలో నడుస్తాయి, కాబట్టి అవి API v1 లో లేవు.
API వినియోగానికి ఎలా వసూలు చేస్తారు?
లైవ్ కీలు Pro మరియు Business తో వస్తాయి. కాల్స్ వెబ్సైట్ లాగే అవే నెలవారీ పరిమితులను వాడతాయి; వాటికి మించితే క్రెడిట్లు వర్తిస్తాయి. క్రెడిట్ ప్యాక్లు 500 క్రెడిట్లకు £5 నుండి మొదలవుతాయి, 12 నెలలు ఉంటాయి.
మీకు SDK లు ఉన్నాయా?
డాక్యుమెంటేషన్లో ప్రతి ఎండ్పాయింట్కు curl, Node, Python లో కాపీ-పేస్ట్ నమూనాలు, OpenAPI 3.1 ఫైల్, Postman కలెక్షన్ ఉన్నాయి, కాబట్టి మీరు ఏ భాషలోనైనా క్లయింట్ను తయారు చేసుకోవచ్చు.
నా వెబ్హుక్ ఎండ్పాయింట్ పని చేయకపోతే ఏమవుతుంది?
మేము 1 నిమిషం, 10 నిమిషాలు, 1 గంట తర్వాత మరో మూడుసార్లు ప్రయత్నిస్తాము, ఆ తర్వాత డెలివరీని విఫలమైనదిగా గుర్తిస్తాము. మీ ఖాతా నుండి లేదా API తో దాన్ని మళ్లీ పంపవచ్చు.
ఈ వారమే PDF ఫీచర్లను విడుదల చేయండి.
ఒక నిమిషంలో శాండ్బాక్స్ కీని సృష్టించండి. కార్డ్ అవసరం లేదు.