توثيق API
قم بتحويل Markdown إلى PDF برمجياً. تسمح لك REST API الخاصة بنا بإنشاء PDF احترافية ومنسقة من محتوى Markdown مع طلب HTTP واحد.
بدء سريع
أنشئ PDF في 30 ثانية بأمر curl بسيط.
احصل على مفتاح API
أنشئ مفتاحًا من لوحة التحكم الخاصة بك تحت API Keys.
اكتب Markdown
يتم دعم أي Markdown صالح — العناوين، القوائم، كتل البرمجة، الجداول، الصور.
قم بالطلب
أرسل طلب POST بمفتاحك و Markdown. استلم 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_... | مفتاح API الخاص بك مسبوقًا بـ Bearer |
| 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
تصميم حديث بسيط بدون سيرف مع تباعد نظيف.
Executive
عناوين مع سيرف بإبرازات كحلية احترافية وأرقام صفحات.
Resume
تخطيط مضغوط ذو عمود واحد محسن للسير الذاتية.
Academic
عناوين مرقّمة، تباعد واسع، وخط EB Garamond للنص الرئيسي.
Legal
نص مع سيرف بتباعد مزدوج مع تنسيق استشهاد رسمي.
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.
تحتاج المزيد؟ اتصل بنا للحصول على تسعير مؤسسي مخصص.