الانتقال إلى المحتوى الرئيسي

PDF Tools API

تحويل HTML إلى PDF API

أضف تحويل HTML إلى PDF إلى الخلفية أو المعالجة الدورية أو منتجك بدون بناء خدمة PDF خاصة بك.

Create API KeyRead full API docs

Credits

1 Credit / call

1 Credit per successful API request. Failed processing attempts are refunded automatically.

Pricing

1,000 Credits = $1

Every signed-in user receives 100 free API Credits each month.

Endpoint

/api/external/html-to-pdf/pdf

Use your API Key in the x-api-key header.

Use case

مناسب لـ تصيير التقارير والإيصالات والكشوف والواجهات الداخلية على الخادم. استخدم أداة الويب للمراجعة اليدوية، واستخدم API للأتمتة المتكررة على الخادم.

cURL example

curl -X POST https://itextmaster.com/api/external/html-to-pdf/pdf \
  -H 'x-api-key: YOUR_API_KEY' \
  -F 'html=@index.html;type=text/html' \
  -F 'pageSize=A4' \
  -F 'printBackground=true' \
  --output html-to-pdf.pdf

Multipart example

curl -X POST https://itextmaster.com/api/external/html-to-pdf/pdf \
  -H 'x-api-key: YOUR_API_KEY' \
  -F 'html=@index.html;type=text/html' \
  -F 'pageSize=A4' \
  -F 'printBackground=true' \
  --output html-to-pdf.pdf

JSON base64 example

curl -X POST https://itextmaster.com/api/external/html-to-pdf/pdf \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "html": "<!doctype html><html><body><h1>Report</h1></body></html>",
    "pageSize": "A4",
    "printBackground": true
  }' \
  --output html-to-pdf.pdf

Node.js example

import { writeFile } from 'node:fs/promises';

const response = await fetch('https://itextmaster.com/api/external/html-to-pdf/pdf', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': process.env.ITEXTMASTER_API_KEY
  },
  body: JSON.stringify({
  html: '<!doctype html><html><body><h1>Report</h1></body></html>',
  pageSize: 'A4',
  printBackground: true
})
});

if (!response.ok) {
  throw new Error(await response.text());
}

await writeFile('html-to-pdf.pdf', Buffer.from(await response.arrayBuffer()));

Python example

import os
import requests

response = requests.post(
    'https://itextmaster.com/api/external/html-to-pdf/pdf',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': os.environ['ITEXTMASTER_API_KEY'],
    },
    json={
        'html': '<!doctype html><html><body><h1>Report</h1></body></html>',
        'pageSize': 'A4',
        'printBackground': True,
    },
)
response.raise_for_status()

with open('html-to-pdf.pdf', 'wb') as f:
    f.write(response.content)

Error codes

400invalid_payload

طلب JSON أو multipart يفتقد إدخال HTML أو URL أو الملف المطلوب.

401invalid_api_key

ترويسة x-api-key غير موجودة أو غير صالحة أو تم تدويرها.

402insufficient_credits

الحساب لا يحتوي على API Credits كافية.

502conversion_failed

لم تكتمل عملية التصيير على الخادم. يتم رد Credits تلقائيًا عند الفشل.

Limits

  • يتطلب ملف PDF صالحًا أو بيانات إدخال صحيحة.
  • استدع API من الخادم حتى لا يظهر API Key في المتصفح.
  • اختبر ملفات ممثلة قبل تشغيل دفعات كبيرة.

Response headers

html-to-pdf.pdf مع ترويسات توضّح Credits المستخدمة والرصيد المتبقي.

Content-Type
نوع MIME للملف الناتج، غالبًا application/pdf أو application/zip.
Content-Disposition
اسم تنزيل الملف الناتج.
X-Credits-Charged
Credits التي تم احتسابها للطلب الناجح.
X-Credit-Balance
رصيد API Credits بعد الطلب.

FAQ

كم تكلفة تحويل HTML إلى PDF API؟

الطلبات الناجحة تستخدم API Credits؛ وتتم إعادة Credits تلقائيًا عند فشل المعالجة. يحصل كل مستخدم مسجل على 100 free API Credits شهريًا، و1,000 Credits = $1.

هل تستخدم أدوات الويب API Credits؟

لا. الأدوات التي تعمل داخل المتصفح لا تستهلك API Credits. تتم المحاسبة فقط على الطلبات التي تستخدم API Key.

هل يمكن استدعاء API من المتصفح؟

لا يُنصح بذلك. احتفظ بـ API Key في الخادم أو قائمة الانتظار أو مهام الأتمتة الخلفية.

Start with 100 free API Credits

Create an API Key, test تحويل HTML إلى PDF API, and buy more Credits only when automation volume grows.

Get API KeyView full API docs