# PDF और डॉक्यूमेंट जनरेशन एपीआई — Zylalabs विवरण
**नीचे दिया गया पाठ Zylalabs के "लंबे विवरण" क्षेत्र में कॉपी-पेस्ट करें:**
---
## अवलोकन
PDF और डॉक्यूमेंट जनरेशन एपीआई एक उत्पादन-ग्रेड REST API है जो HTML, URLs और संरचित डेटा को पिक्सेल-परिपूर्ण PDF दस्तावेज़ों में परिवर्तित करता है। इसे डेवलपर्स के लिए बनाया गया है जिन्हें दस्तावेज़ कार्यप्रवाहों को स्वचालित करने की आवश्यकता होती है — चालान, रसीदें, रिपोर्ट, अनुबंध, डैशबोर्ड — बिना ब्राउज़र इंजनों, Chromium सर्वरों, या रेंडरिंग अवसंरचना प्रबंधित किए।
ProdaDoc द्वारा संचालित, यह एपीआई पूरी PDF पाइपलाइन को संभालता है: निर्माण, विलय, और मेटाडेटा निकासी, सभी सरल JSON-इन, PDF-आउट एंडपॉइंट्स के माध्यम से।
## मुख्य विशेषताएँ
**HTML से PDF रूपांतरण**
कोई भी HTML स्ट्रिंग भेजें — पूर्ण CSS समर्थन के साथ जिसमें Flexbox, Grid, कस्टम फॉन्ट, और प्रिंट मीडिया क्वेरी शामिल हैं — और मिलीसेकंड में एक उत्पादन-गुणवत्ता PDF प्राप्त करें। ईमेल टेम्पलेट्स, डैशबोर्ड, और कस्टम दस्तावेज़ों को डाउनलोड करने योग्य PDFs में परिवर्तित करने के लिए बहुत अच्छा।
**URL से PDF रूपांतरण**
कोई भी सार्वजनिक रूप से सुलभ वेबपेज को PDF दस्तावेज़ में परिवर्तित करें। एपीआई पूरे पृष्ठ को रेंडर करता है जिसमें JavaScript-जनित सामग्री शामिल होती है, जिससे यह वेब पृष्ठों को संग्रहित करने, अनुपालन स्नैपशॉट उत्पन्न करने, या वेब सामग्री की ऑफ़लाइन प्रतियाँ बनाने के लिए आदर्श बनाता है।
**टेम्पलेट-आधारित PDF जनरेशन**
संरचित JSON डेटा भेजकर पूर्व-निर्मित टेम्पलेट्स से पेशेवर दस्तावेज़ उत्पन्न करें। उपलब्ध टेम्पलेट्स में शामिल हैं:
- **चालान टेम्पलेट** — लाइन आइटम, कर गणना, कंपनी ब्रांडिंग, भुगतान शर्तें, और ग्राहक विवरण
- **रसीद टेम्पलेट** — लेनदेन रिकॉर्ड जिसमें भुगतान विधि, लेनदेन ID, और वस्तुवादी खरीद शामिल हैं
- **रिपोर्ट टेम्पलेट** — कार्यकारी सारांश, डेटा अनुभाग, निष्कर्ष, और गोपनीय मार्किंग के साथ बहु-खंड व्यवसाय रिपोर्ट
**PDF विलय**
एक API कॉल के साथ 2 से 20 अलग-अलग PDF दस्तावेज़ों को एक ही विलयित फ़ाइल में संयोजित करें। अनुबंध पैकेज इकट्ठा करने, मल्टी-पेज रिपोर्ट संयोजित करने, या वितरण के लिए संबंधित दस्तावेज़ों को बंडल करने के लिए आवश्यक।
**PDF मेटाडेटा निकासी**
किसी भी PDF फ़ाइल से विस्तृत जानकारी निकालें जिसमें पृष्ठ गणना, व्यक्तिगत पृष्ठ आयाम (चौड़ाई और ऊँचाई), और दस्तावेज़ गुण शामिल हैं। स्वचालित कार्यप्रवाहों में PDF फ़ाइलों के सत्यापन, सूचीबद्ध करने और पूर्व-प्रक्रिया के लिए उपयोगी।
## एपीआई एंडपॉइंट्स
| विधि | एंडपॉइंट | विवरण |
|--------|----------|-------------|
| GET | /health | स्वास्थ्य जांच और एपीआई स्थिति (कोई प्रमाणीकरण आवश्यक नहीं) |
| POST | /api/v1/pdf/from-html | एक HTML स्ट्रिंग से PDF उत्पन्न करें |
| POST | /api/v1/pdf/from-url | एक वेब पेज URL से PDF उत्पन्न करें |
| POST | /api/v1/pdf/from-template | गतिशील डेटा के साथ पूर्व-निर्मित टेम्पलेट से PDF उत्पन्न करें |
| POST | /api/v1/pdf/merge | कई PDF फ़ाइलों को एक दस्तावेज़ में विलय करें |
| POST | /api/v1/pdf/metadata | एक PDF से पृष्ठ संख्या और आयाम निकालें |
## अनुकूलन विकल्प
हर PDF जनरेशन एंडपॉइंट व्यापक अनुकूलन का समर्थन करता है:
- **पृष्ठ प्रारूप:** A3, A4, A5, पत्र, विधि
- **उन्मुखता:** पोर्ट्रेट या लैंडस्केप
- **मार्जिन:** व्यक्तिगत शीर्ष, दाएँ, नीचे, और बाँए मार्जिन मिलीमीटर में
- **स्केल:** सामग्री स्केलिंग को 10% से 200% तक समायोजित करें
- **पृष्ठभूमि प्रिंटिंग:** CSS पृष्ठभूमि रंग और छवियों को शामिल या बाहर करना
- **हेडर और फुटर:** पृष्ठ संख्याओं के साथ कस्टम HTML हेडर और फुटर टेम्पलेट्स
## सामान्य उपयोग के मामले
**SaaS प्लेटफार्म** — स्वचालित रूप से मासिक चालान, उपयोग रिपोर्ट, और उपयोगकर्ता डेटा को डाउनलोड करने योग्य PDF फ़ाइलों के रूप में सीधे अपने एप्लिकेशन बैकएंड से उत्पन्न करें।
**ई-कॉमर्स और रिटेल** — भुगतान विधि की जानकारी (क्रेडिट कार्ड, PayPal, M-Pesa, बैंक ट्रांसफर) और ग्राहक रिकॉर्ड के लिए लेनदेन पहचानकर्ताओं के साथ मूल्यवर्गित खरीद रसीदें प्रिंट करें।
**कानूनी और वित्तीय सेवाएं** — कई अनुबंध पृष्ठों, NDA, सेवा की शर्तों, और संशोधन दस्तावेज़ों को ग्राहक हस्ताक्षर के लिए एकल बंडल किए गए PDF में विलय करें।
**फ्रीलांसर और एजेंसियाँ** — कंपनी लोगो, भुगतान शर्तें, और लाइन-आइटम बिलिंग के साथ ब्रांडेड चालान सेकंडों में बनाएं बिना किसी डिज़ाइन सॉफ़्टवेयर के।
**स्वास्थ्य देखभाल और चिकित्सा** — मरीज रिपोर्ट, डिस्चार्ज सारांश, और अपॉइंटमेंट पुष्टि जैसे सुरक्षित PDF दस्तावेज़ उत्पन्न करें।
**शिक्षा** — छात्र डेटा रिकॉर्ड से प्रमाणपत्र, प्रतिलेख, और मूल्यांकन रिपोर्ट बनाएं।
**रियल एस्टेट** — संरचित डेटा से संपत्ति लिस्टिंग शीट, किराए के समझौतों, और निरीक्षण रिपोर्ट उत्पन्न करें।
## सुरक्षा
इस एपीआई ने एक व्यापक 28-पॉइंट सुरक्षा ऑडिट किया है जिसमें शामिल हैं:
- हर एंडपॉइंट पर सख्त स्कीमा सत्यापन का इनपुट मान्यकरण
- SSRF (सर्वर-साइड अनुरोध धोखाधड़ी) सुरक्षा जो लोकलहोस्ट, निजी IPs, और क्लाउड मेटाडेटा एंडपॉइंट्स के लिए पहुंच अवरोधित करती है
- सभी टेम्पलेट्स में HTML एंटिटी एस्केपिंग के साथ XSS रोकथाम
- समय-प्रमाणित एपीआई कुंजी प्रमाणीकरण समय हमलों को रोकने के लिए
- दुरुपयोग को रोकने के लिए हर एपीआई कुंजी के लिए दर सीमा निर्धारण
- सुरक्षा हेडर जिनमें HSTS, कंटेंट सुरक्षा नीति, और X-फ्रेम-ऑप्शंस शामिल हैं
- उत्पन्न PDFs का कोई भंडारण नहीं — दस्तावेज़ तुरंत लौटाए जाते हैं और कभी भी बनाए नहीं जाते
## एकीकरण उदाहरण
एकल HTTP अनुरोध के साथ एक चालान PDF उत्पन्न करें:
```
POST /api/v1/pdf/from-template
Content-Type: application/json
x-api-key: YOUR_API_KEY
{
"template": "invoice",
"data": {
"companyName": "आपकी कंपनी",
"clientName": "ग्राहक का नाम",
"invoiceNumber": "INV-001",
"items": [
{
"description": "सलाहकार सेवाएँ",
"quantity": 10,
"unitPrice": 150,
"amount": 1500
}
],
"total": 1500,
"currency": "USD"
}
}
```
उत्तर: कच्चा PDF बाइनरी फ़ाइल (application/pdf सामग्री प्रकार)
## प्रदर्शन
- औसत उत्तर समय: HTML से PDF के लिए 400 मिलीसेकंड से कम
- प्रबंधित ब्राउज़र पूल के साथ समवर्ती अनुरोध प्रबंधन
- विफलताओं से स्वचालित वसूली के लिए सर्किट ब्रेकर पैटर्न
- अंत-से-अंत दृश्यता के लिए हर एपीआई कॉल पर अनुरोध ID ट्रेसिंग
## त्रुटि प्रबंधन
सभी त्रुटियाँ संरचित JSON प्रतिक्रियाएँ लौटाती हैं जिनमें शामिल हैं:
- एक मशीन-पठनीय त्रुटि कोड (VALIDATION_ERROR, UNAUTHORIZED, RATE_LIMITED, आदि)
- एक मानव-पठनीय त्रुटि संदेश जो बताता है कि क्या गलत हुआ
- एक पुनः कोशिश करने योग्य ध्वज जो इंगित करता है कि क्या अनुरोध को पुनः आजमाया जा सकता है
कभी भी एपीआई उपभोक्ताओं के लिए स्टैक ट्रेस या आंतरिक सर्वर विवरण प्रकट नहीं किए जाते
एपीआई स्थिति और अपटाइम की जांच करें। PDF रेंडरिंग इंजन का परीक्षण करने और मेमोरी उपयोग आँकड़े प्राप्त करने के लिए ?deep=true जोड़ें। किसी प्रमाणीकरण की आवश्यकता नहीं है।
स्वास्थ्य जांच - एंडपॉइंट फीचर्स
| ऑब्जेक्ट | विवरण |
|---|
{"status":"healthy","timestamp":"2026-03-13T14:10:46.756Z","uptime":154731,"version":"1.0.0"}
curl --location --request GET 'https://zylalabs.com/api/12011/html+to+pdf+generation+api/22873/health+check' --header 'Authorization: Bearer YOUR_API_KEY'
एक PDF दस्तावेज़ का विश्लेषण करें और विस्तृत मेटाडेटा निकालें जिसमें शीर्षक, लेखक, विषय, निर्माता, उत्पादक, निर्माण की तारीख, संशोधन की तारीख, कुल पृष्ठों की संख्या और पृष्ठों का व्यक्तिगत आयाम (जोड़ और ऊंचाई में बिंदु) शामिल हैं PDF को बेस64 में एन्कोडेड स्ट्रिंग के रूप में भेजें अधिकतम आकार: 50MB जवाब JSON है
PDF से मेटाडेटा निकालें - एंडपॉइंट फीचर्स
| ऑब्जेक्ट | विवरण |
|---|---|
रिक्वेस्ट बॉडी |
[आवश्यक] Json |
{"metadata":{"title":null,"author":null,"subject":null,"creator":"pdf-lib (https://github.com/Hopding/pdf-lib)","producer":"pdf-lib (https://github.com/Hopding/pdf-lib)","creationDate":"2026-03-13T14:13:21.000Z","modificationDate":"2026-03-13T14:13:21.000Z","pageCount":1,"pages":[{"index":0,"width":72,"height":72}]},"requestId":"ded7bd08-06c3-451d-8767-87516d81b086"}
curl --location --request POST 'https://zylalabs.com/api/12011/html+to+pdf+generation+api/22878/extract+pdf+metadata' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{
"pdf": "JVBERi0xLjcKCjEgMCBvYmogICUKPDwvVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCgoyIDAgb2JqCjw8L1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPj4KZW5kb2JqCgozIDAgb2JqCjw8L1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA3MiA3Ml0KPj4KZW5kb2JqCgp4cmVmCjAgNAowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMTAgMDAwMDAgbiAKMDAwMDAwMDA2MCAwMDAwMCBuIAowMDAwMDAwMTE2IDAwMDAwIG4gCnRyYWlsZXIKPDwvU2l6ZSA0Ci9Sb290IDEgMCBSCj4+CnN0YXJ0eHJlZgoxNzMKJSVFT0YK"
}'
| हेडर | विवरण |
|---|---|
Authorization
|
[आवश्यक] होना चाहिए Bearer access_key. जब आप सब्सक्राइब हों तो ऊपर "Your API Access Key" देखें। |
कोई लंबी अवधि की प्रतिबद्धता नहीं। कभी भी अपग्रेड, डाउनग्रेड या कैंसल करें। फ्री ट्रायल में 50 रिक्वेस्ट तक शामिल हैं।
प्रत्येक एंडपॉइंट विशिष्ट डेटा प्रकार लौटाता है: HTML से PDF, URL से PDF और टेम्पलेट PDF उत्पन्न करने वाले एंडपॉइंट बाइनरी PDF फ़ाइलें लौटाते हैं PDF मर्जिंग एंडपॉइंट भी एक बाइनरी PDF फ़ाइल लौटाता है मेटाडेटा एक्सट्रैक्शन एंडपॉइंट एक JSON ऑब्जेक्ट लौटाता है जिसमें PDF के बारे में विस्तृत मेटाडेटा शामिल होता है जिसमें शीर्षक लेखक और पृष्ठ गणना शामिल है
मेटाडेटा निष्कर्षण प्रतिक्रिया में मुख्य क्षेत्र "शीर्षक," "लेखक," "विषय," "निर्माता," "उत्पादक," "निर्माण तिथि," "संशोधन तिथि," और "पृष्ठ गणना" शामिल हैं प्रत्येक पृष्ठ के आयाम "पृष्ठों" सूची में भी शामिल हैं
ओ एंडपॉइंट HTML से PDF में "html" (HTML सामग्री) "filename" (चाहे गए PDF फ़ाइल का नाम) और वैकल्पिक सेटिंग्स के लिए "options" जैसे पैरामीटर स्वीकार करता है जिसमें "format" (A3, A4 आदि) "landscape" (सत्य/असत्य) "printBackground" (सत्य/असत्य) और "margin" सेटिंग शामिल हैं
PDF मिलाने के अंत बिंदु के लिए प्रतिक्रिया डेटा बाइनरी PDF फ़ाइल के रूप में व्यवस्थित है मिलाई गई दस्तावेज़ में उन सभी पृष्ठों को शामिल किया गया है जो इनपुट PDFs में दिए गए थे उस क्रम में जिसमें उन्हें प्रदान किया गया था यह दस्तावेजों का एक सुचारू संयोजन सुनिश्चित करता है
पीडीएफ मेटाडेटा निष्कर्षण अंतिम बिंदु दस्तावेज़ के शीर्षक, लेखक, विषय, निर्माता, उत्पादक, निर्माण और संशोधन तिथियों, कुल पृष्ठ संख्या और व्यक्तिगत पृष्ठ आयामों जैसी जानकारी प्रदान करता है जिससे व्यापक दस्तावेज़ विश्लेषण की अनुमति मिलती है
उपयोगकर्ता अपने अनुरोधों को अनुकूलित कर सकते हैं द्वारा संरचित JSON डेटा भेजने से जिसमें चयनित टेम्पलेट (चालान, रसीद, या रिपोर्ट) से संबंधित विशेष फ़ील्ड शामिल हैं प्रत्येक टेम्पलेट गतिशील डेटा इनपुट की अनुमति देता है जैसे चालानों के लिए लाइन आइटम या रसीदों के लिए लेनदेन विवरण
प्रचलित उपयोग के मामलों में एचटीएमएल टेम्प्लेट से डाउनलोड करने योग्य चालान उत्पन्न करना शामिल है अनुपालन के लिए वेब पृष्ठों को पीडीएफ के रूप में संग्रहित करना और ऐसे रिपोर्ट या डैशबोर्ड बनाना शामिल हैं जिन्हें एक पोर्टेबल प्रारूप में साझा करने की आवश्यकता होती है
उपयोगकर्ता बाइनरी पीडीएफ प्रतिक्रिया को सीधे .pdf एक्सटेंशन वाली फ़ाइल में सहेज सकते हैं यह दस्तावेज़ों को साझा करने प्रिंट करने या संग्रहित करने के लिए आसान बनाता है जो एपीआई के माध्यम से उत्पन्न होते हैं यह सुनिश्चित करता है कि वे इच्छित स्वरूपण और गुणवत्ता बनाए रखते हैं
एचटीएमएल से पीडीएफ में कन्वर्ज़न के लिए अंतिम बिंदु का अधिकतम आकार 5MB है पीडीएफ के विलय के लिए प्रत्येक पीडीएफ फ़ाइल का अधिकतम आकार 50MB होना चाहिए मेटाडेटा निकालने का अंतिम बिंदु भी 50MB तक के पीडीएफ को स्वीकार करता है
उपयोगकर्ता PDFs की उपस्थिति को अनुकूलित कर सकते हैं जैसे "फॉर्मेट" (A3, A4 आदि), "दिशा" (पोर्ट्रेट या लैंडस्केप), "मार्जिन" (ऊपरी, निचले आदि), और "पृष्ठभूमि प्रिंट" (रंग और पृष्ठभूमि छवियाँ शामिल करना या छोड़ना)
यदि अनुरोध विफल होता है तो API एक संरचित JSON प्रतिक्रिया लौटाएगी जिसमें एक त्रुटि कोड एक व्याख्यात्मक संदेश और एक पुनरावृत्ति ध्वज होगा जो यह इंगित करता है कि क्या अनुरोध को दोहराया जा सकता है
सही रेंडरिंग सुनिश्चित करने के लिए उपयोगकर्ताओं को मान्य और अच्छी तरह से संरचित HTML भेजना चाहिए जिसमें संगत CSS शामिल हो। API Flexbox, Grid और कस्टम फॉण्ट्स का समर्थन करता है जो सटीक प्रारूपण की अनुमति देता है
उपलब्ध मॉडल में लाइन आइटम और भुगतान विवरण के साथ चालान ट्रांजेक्शन रिकॉर्ड के साथ रसीद और कई सेक्शन और कार्यकारी सारांश के साथ रिपोर्ट शामिल हैं जो पेशेवर दस्तावेज़ों के निर्माण की अनुमति देते हैं
उपयोगकर्ता 2 से 20 पीडीएफ को मर्ज कर सकते हैं प्रत्येक फ़ाइल को एक बेस64 कोडेड स्ट्रिंग के रूप में भेजकर एपीआई एकल पीडीएफ लौटाएगा जो प्रदत्त क्रम में इनपुट दस्तावेजों के सभी पृष्ठों को सम्मिलित करता है
एक यूआरएल को प्रोसेस करने के लिए, पृष्ठ का सार्वजनिक रूप से उपयोग किया जाना आवश्यक है। एपीआई पूरी तरह से पृष्ठ को रेंडर करता है, जिसमें जावास्क्रिप्ट द्वारा उत्पन्न सामग्री शामिल है, लेकिन सुरक्षा कारणों से लोकलहोस्ट या प्राइवेट आईपी को एक्सेस करने वाली यूआरएल को ब्लॉक कर देता है
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
801ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
597ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
401ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
227ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,371ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
4,605ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
22ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
906ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
11,333ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,815ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
819ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,074ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
796ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
771ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
883ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
2,060ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,189ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
3,137ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
4,904ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
896ms