واجهة API وخادم MCP لتحويل Markdown إلى PDF مصقول ومخصص للمهمة
أنشئ مستندات Markdown ذات إصدارات، وانشر ملفات PDF مصقولة بشكل غير متزامن، ونزّل ملفات موثقة عبر REST API بصلاحيات محددة.
تجربة premium
/api/v2/documents{
"taskId": "consulting-proposal",
"revision": {
"markdown": "# Northstar Proposal...",
"spec": { "templateId": "proposal-consulting" }
}
}
SHA-256POST /api/v2/documents → /publishes
بدء سريع
أنشئ مستندًا وانشره ثم نزّل ملف PDF الموثق.
#!/usr/bin/env bash
set -euo pipefail
API="https://markdowntopdfconverter.com"
RUN_ID="proposal-$(date +%s)"
AUTH="Authorization: Bearer $MD2PDF_API_KEY"
DOCUMENT=$(curl --fail --silent --show-error --max-time 30 "$API/api/v2/documents" \
-H "$AUTH" -H "Content-Type: application/json" \
-H "Idempotency-Key: $RUN_ID-document" \
--data '{"taskId":"consulting-proposal","title":"Northstar proposal","revision":{"markdown":"# Northstar Proposal\n\n## Outcome\nA decision-ready roadmap.","parentRevisionId":null,"spec":{"locale":"en","options":{"pageNumbers":true},"templateId":"proposal-consulting"}}}')
DOCUMENT_ID=$(jq -r '.document.id' <<<"$DOCUMENT")
REVISION_ID=$(jq -r '.revision.id' <<<"$DOCUMENT")
JOB=$(curl --fail --silent --show-error --max-time 30 \
"$API/api/v2/documents/$DOCUMENT_ID/publishes" \
-H "$AUTH" -H "Content-Type: application/json" \
-H "Idempotency-Key: $RUN_ID-publish" \
--data "{"revisionId":"$REVISION_ID","output":{"format":"pdf","filename":"northstar-proposal.pdf"}}")
JOB_ID=$(jq -r '.job.id' <<<"$JOB")
for ATTEMPT in $(seq 1 100); do
RESULT=$(curl --fail --silent --show-error --max-time 30 "$API/api/v2/jobs/$JOB_ID" -H "$AUTH")
STATUS=$(jq -r '.job.status' <<<"$RESULT")
[[ "$STATUS" == "succeeded" ]] && break
[[ "$STATUS" == "failed" || "$STATUS" == "cancelled" ]] && exit 1
sleep 3
done
[[ "$STATUS" == "succeeded" ]] || { echo "Timed out waiting for PDF" >&2; exit 1; }
ARTIFACT_ID=$(jq -r '.artifact.id' <<<"$RESULT")
LINK=$(curl --fail --silent --show-error --max-time 30 -X POST \
"$API/api/v2/artifacts/$ARTIFACT_ID/links" -H "$AUTH")
HREF=$(jq -r '.href' <<<"$LINK")
[[ "$HREF" == https://* ]] || { echo "Refusing non-HTTPS artifact URL" >&2; exit 1; }
curl --fail --location --proto '=https' --max-redirs 5 --max-time 60 "$HREF" \
--output northstar-proposal.pdf
- Artifact
- SHA-256
- Download
- private link
ابدأ بأتمتة تمت مراجعتها
استورد مسار النشر والمتابعة والتنزيل الخاص كاملًا.
n8n
سير عمل غير نشط مع انتظار مستمر ومعالجة حالات الفشل النهائية.
Make
مخطط بلا بيانات اعتماد مع متابعة محدودة ومنع التنزيل المكرر.
Zapier
خطوة SDK وبيان قالب إرشادي في حزمة واحدة.
استخدم مفتاحًا مخصصًا بصلاحيتي documents.render وdocuments.read. نزّل الرابط الموقّع من دون هذا المفتاح.
استخدم قوالب PDF المصقولة من Claude Code ووكلاء الذكاء الاصطناعي
اربط خادم MCP البعيد مرة واحدة، ثم اطلب من الوكيل اقتراح أنسب القوالب لمستندك أو تحويل Markdown إلى PDF مصقول من داخل المحادثة.
{
"mcpServers": {
"markdown-to-pdf": {
"type": "http",
"url": "https://markdowntopdfconverter.com/mcp",
"headers": {
"Authorization": "Bearer ${MD2PDF_API_KEY}"
}
}
}
}يستخدم MCP مفتاح API والحصة نفسيهما في REST API. كل نتيجة رابط تنزيل خاص تنتهي صلاحيته بعد 15 دقيقة، ويمكن للحسابات المجانية تجربة 5 تصديرات مميزة قبل الترقية.
إنشاء مفتاح APIالمصادقة
تحقّق من كل طلب باستخدام مفتاح API السري الخاص بك، المُرسَل كرمز Bearer في ترويسة Authorization.
ترويسة الطلب
| الترويسة | القيمة | الوصف |
|---|---|---|
| Authorization | Bearer mp_live_... | مفتاح API الخاص بك مسبوقًا بـ Bearer |
| Content-Type | application/json | مطلوب لجميع الطلبات |
دورة نشر مُدارة واحدة
يبقى المصدر والمراجعة الثابتة والمهمة والملف الموثق منفصلة لتكون الإعادات والتدقيقات متوقعة.
- 01
أنشئ مستندًا مُدارًا ومراجعته الأولى.
- 02
اطلب ملف PDF النهائي بمفتاح ثبات مستقر.
- 03
تابع حتى succeeded أو failed أو cancelled.
- 04
أنشئ رابطًا خاصًا قصير الصلاحية للملف.
- 05
نزّل الرابط الموقّع من دون تمرير Authorization.
POST /api/v1/convert
حول Markdown إلى مستند PDF منسق.
القوالب
اختر من بين 57 قالبًا احترافيًا ضمن 9 عائلات مخصّصة للمهام. افتح أي عائلة لنسخ معرّف القالب.
السير الذاتيةتنسيقات واضحة ومهنية لانطباع أول قوي.10 IDs
خطابات التقديمخطابات مصممة لتتكامل مع سيرتك الذاتية.10 IDs
الواجبات الدراسيةتنسيقات متقنة لواجبات المدرسة والكلية والجامعة.9 IDs
المقترحاتمقترحات احترافية لكسب العملاء والموافقات والشراكات والتمويل.9 IDs
المبيعات والتسويقمواد مصقولة للبيع وإثبات النتائج وإطلاق المنتجات.9 IDs
المستندات الأكاديميةتنسيقات للنشر والتحكيم وأوراق المؤتمرات.3 IDs
الكتب والنصوص الطويلةتخطيطات مريحة للقراءة للأدلة والكتيبات والمقالات والكتب.4 IDs
المستندات القانونيةاتفاقيات وعقود منظمة بوضوح.1 IDs
أكواد الخطأ
يتضمن كل خطأ في v2 رمزًا ثابتًا وحالة HTTP وعلامة retryable وتأخيرًا اختياريًا لإعادة المحاولة. أعد المحاولة فقط عندما تكون retryable مساوية لـ true.
400 / 415 / 422invalid_request
retryable: false
401unauthorized
retryable: false
402quota_exhausted
retryable: false
403forbidden
retryable: false
404not_found
retryable: false
409idempotency_conflict
retryable: false
409invalid_state_transition
retryable: false
410artifact_expired
retryable: false
429rate_limited
retryable: true
503service_unavailable
retryable: true
| الحالة | code | retryable |
|---|---|---|
| 400 / 415 / 422 | invalid_request | false |
| 401 | unauthorized | false |
| 402 | quota_exhausted | false |
| 403 | forbidden | false |
| 404 | not_found | false |
| 409 | idempotency_conflict | false |
| 409 | invalid_state_transition | false |
| 410 | artifact_expired | false |
| 429 | rate_limited | true |
| 503 | service_unavailable | true |
تسعير API
يتم تتبع استدعاءات API شهرياً. كل تحويل ناجح يحسب في الحد الشهري للخطة الخاصة بك.
0 CA$
25 / month
13.91 CA$ / month
500 / month
82.14 CA$ / year
1,000 / month
6.96 CA$ one-time
250 calls
تحتاج المزيد؟ اتصل بنا للحصول على تسعير مؤسسي مخصص.
قبل مغادرة التوثيق