API दस्तावेज़
प्रोग्रामेटिकली Markdown को PDF में बदलें। हमारी REST API आपको एक ही HTTP अनुरोध से Markdown सामग्री से पेशेवरा, स्टाइलिश्ड PDF बनाने देती है।
त्वरित आरंभ
30 सेकंड में एक सरल curl कमांड से PDF जनरेट करें।
अपनी API कुंजी प्राप्त करें
API Keys के तहत अपने डैशबोर्ड से एक कुंजी जनरेट करें।
Markdown लिखें
कोई भी मान्य Markdown समर्थित है — शीर्षक, सूचियाँ, कोड ब्लॉक, टेबल, छवियाँ।
अनुरोध करें
अपनी कुंजी और Markdown के साथ POST अनुरोध भेजें। वापस PDF प्राप्त करें।
curl -X POST https://markdowntopdfconverter.com/api/v1/convert \
-H "Authorization: Bearer mp_live_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{"markdown": "# Hello World\n\nThis is a **test**.", "templateId": "clean"}' \
-o output.pdfप्रमाणीकरण
apiDocs.authentication.description
अनुरोध हेडर
| हेडर | मान | विवरण |
|---|---|---|
| Authorization | Bearer mp_live_... | Bearer उपसर्ग के साथ आपकी API कुंजी |
| Content-Type | application/json | सभी अनुरोधों के लिए आवश्यक |
apiDocs.authentication.keyFormat
POST /api/v1/convert
Markdown को एक स्टाइलिश्ड PDF दस्तावेज़ में बदलें।
अनुरोध का मदन
markdownstringआवश्यककन्वर्ट करने के लिए Markdown सामग्री। अधिकतम 200,000 अक्षर।
templateIdstringऐच्छिकउपयोग करने के लिए टेम्पलेट। एक: clean, executive, resume, academic, legal, creative। डि॑ल्ट: clean।
filenamestringऐच्छिकडाउनलोड किए गए PDF फ़ाइल का नाम। डि॑ल्ट: document.pdf।
localestringऐच्छिकरेंडरिंग के लिए स्थानीयता। एक: en, es, fr, de, ja, zh-CN, ko, pt-BR, ar, ru, hi, it। डि॑ल्ट: en।
customTemplateIdUUIDऐच्छिकसहेज कस्टम टेम्पलेट का UUID। टेम्पलेट API कुंजी के उपयोगकर्ता के स्वामित्व में होना चाहिए।
optionsobjectऐच्छिककन्वर्शन विकल्प: pageNumbers (boolean), bodyTextColor (hex), headingTextColor (hex), creativeAccent (slate|purple|blue|emerald|rose|amber)।
अनुरोधों के उदाहरण
import requests
api_key = "mp_live_your_api_key_here"
headers = {
"Authorization": f"Bearer {api_key}",
"Content-Type": "application/json"
}
payload = {
"markdown": "# Quarterly Report\n\n## Revenue\n\nRevenue grew **15%** this quarter.",
"templateId": "executive",
"options": {"pageNumbers": True}
}
response = requests.post(
"https://markdowntopdfconverter.com/api/v1/convert",
json=payload,
headers=headers
)
with open("report.pdf", "wb") as f:
f.write(response.content)const response = await fetch(
"https://markdowntopdfconverter.com/api/v1/convert",
{
method: "POST",
headers: {
Authorization: `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
markdown: "# Invoice\n\n**Amount:** $1,200\n\n| Item | Qty | Price |\n| --- | --- | --- |\n| Widget | 5 | $240 |",
templateId: "clean",
filename: "invoice",
}),
}
);
const blob = await response.blob();
const url = URL.createObjectURL(blob);
// Trigger download
const a = document.createElement("a");
a.href = url;
a.download = "invoice.pdf";
a.click();टेम्पलेट
छह पेशेवर डिजाइन किए गए टेम्पलेट में से चुनें। प्रत्येक टेम्पलेट में अलग टाइपोग्राफी, स्पेसिंग और रंग योजनाएँ हैं।
Clean
सफ़ स्पेसिंग के साथ न्यूनतम, आधुनिक sans-serif डिजाइन।
Executive
पेशेवर नेवी एक्सेंट और पेज नंबर के साथ Serif शीर्षक।
Resume
रेज्यूमे के लिए ऑप्टिमाइज़्ड कंपैक्ट एक-कॉलम लेआउट।
Academic
क्रमांकित शीर्षक, उदार स्पेसिंग, और EB Garamond बॉडी।
Legal
आपलिक उद्दरण फ़ॉर्मेटिंग के साथ डबल-स्पेस्ड serif बॉडी।
Creative
कॉन्॑िगरेबल एक्सेंट रंगों के साथ बोल्ड DM Sans शीर्षक।
त्रुटि कोड
प्रत्येक प्रतिक्रिया एक मानक HTTP स्थिति कोड का उपयोग करती है। परिणाम कैसे संभालना है, यह तय करने के लिए इसका उपयोग करें।
| स्थिति | अर्थ | कार्रवाई |
|---|---|---|
| 200 | सफलता — PDF वापस किया गया | प्रतिक्रिया निकाय से PDF डाउनलोड करें। |
| 400 | अमान्य अनुरोध मदन | जाँचें कि आपका JSON पैलोड ऊपर दिए स्कीमा से मेल खाता है। |
| 401 | अमान्य या गायब API कुंजी | पुष्टि करें कि आपकी API कुंजी सक्रिय और सही ढंग से स्वरूपित है। |
| 402 | API क्रेडिट समाप्त | अपने डैशबोर्ड से और क्रेडिट खरीदें। |
| 404 | कस्टम टेम्पलेट नहीं मिला | पुष्टि करें कि customTemplateId सही है और आपसे संबंधित है। |
| 415 | गलत Content-Type | Content-Type हेडर को application/json पर सेट करें। |
| 422 | अमान्य कन्वर्शन विकल्प | जाँचें कि आपका options ऑब्जेक्ट स्पेक से मेल खाता है। |
| 429 | दर सीमित | प्रतीक्षा करें और पुनः प्रयास करें। Retry-After हेडर जाँचें। |
| 500 | सर्वर त्रुटि | एक्सपोनेंशियल बैकआफ के साथ पुनः प्रयास करें। बना रहने पर सहायता से संपर्क करें। |
API मूल्य निर्धारण
API कॉल्स मासिक रूप से ट्रैक की जाती हैं। प्रत्येक सफल कन्वर्शन आपके स्तर की मासिक सीमा में गिना जाता है।
$0
25 / month
परीक्षण और मूल्यांकन के लिए।
$9
500 / month
व्यक्तिगत और छोटे परियोजनाओं के लिए।
$29
1,000 / month
प्राथमिकता जनरेशन, API के माध्यम से कस्टम टेम्पलेट सहायता।
और चाहिए? कस्टम एंटरप्राइज मूल्य निर्धारण के लिए हमसे संपर्क करें।