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-இலிருந்து ஆவணத்தை உருவாக்கி, உரைக் குறிச்சொற்களால் புலங்களை வைத்து, அனுப்பி, கையொப்பமிட்ட நகலைப் பதிவிறக்குங்கள்.
கையொப்பமிடுவதை உங்கள் தயாரிப்பில் உட்பொதியுங்கள்
நீங்கள் அனுமதிக்கும் origin-களுக்கு மட்டும் வரையறுத்து, உங்கள் தளத்துக்குள்ளேயே கையொப்ப அமர்வைத் திறக்கவும்.
வெப்ஹூக்குகளுடன் தொகுப்புகளை இயக்குங்கள்
நூற்றுக்கணக்கான பணிகளைத் தொடங்கி, ஒவ்வொன்றும் முடிந்ததும் கையொப்பமிட்ட கால்பேக்கைப் பெறுங்கள்.
இது எப்படி வேலை செய்கிறது
விசையிலிருந்து முடிவு வரை நான்கு அழைப்புகளில்
விசையை உருவாக்குங்கள்
உங்கள் கணக்கில் சாண்ட்பாக்ஸ் விசையை உருவாக்குங்கள். தயாரானதும் நேரடி விசைக்கு மாறுங்கள்.
கணக்கு › டெவலப்பர்பணியைத் தொடங்குங்கள்
கோப்புகளையும் கருவியையும் ஒரே multipart கோரிக்கையில் அனுப்புங்கள்.
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 செயலாக்கமும், கூடவே பொறியியல் குழு எதிர்பார்க்கும் கட்டுப்பாடுகளும்.
- நீங்கள் கட்டுப்படுத்தும் விசைகள்நேரடி மற்றும் சாண்ட்பாக்ஸ் விசைகள் ஒருமுறை மட்டுமே காட்டப்பட்டு, ஹாஷ் ஆகச் சேமிக்கப்படும். எந்த விசையையும் உங்கள் கணக்கிலிருந்து திரும்பப் பெறலாம்.
- கையொப்பமிட்ட வெப்ஹூக்குகள்ஒவ்வோர் அனுப்புதலிலும் ?signature= இருக்கும்; இது உங்கள் பகிரப்பட்ட விசையால் உருவாக்கப்பட்ட உள்ளடக்கத்தின் HMAC-SHA256 ஆகும்.
- கோப்புகள் விரைவாக நீக்கப்படும்பணிக் கோப்புகள் இலவசக் கணக்கில் 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 கருவிகள் — Compress, 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 அம்சங்களை வெளியிடுங்கள்.
ஒரு நிமிடத்தில் சாண்ட்பாக்ஸ் விசையை உருவாக்குங்கள். கார்டு தேவையில்லை.