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

PDF Tools API

إنشاء فواتير PDF API

أضف إنشاء فواتير 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/invoice-generator/pdf

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

Use case

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

cURL example

curl -X POST https://itextmaster.com/api/external/invoice-generator/pdf \
  -H 'x-api-key: YOUR_API_KEY' \
  -F 'invoiceNumber=INV-001' \
  -F 'fromName=Your Company' \
  -F 'billToName=Client Name' \
  -F 'items=[{"description":"Consulting","quantity":10,"rate":150}]' \
  --output invoice.pdf

Multipart example

curl -X POST https://itextmaster.com/api/external/invoice-generator/pdf \
  -H 'x-api-key: YOUR_API_KEY' \
  -F 'invoiceNumber=INV-001' \
  -F 'fromName=Your Company' \
  -F 'billToName=Client Name' \
  -F 'items=[{"description":"Consulting","quantity":10,"rate":150}]' \
  --output invoice.pdf

JSON base64 example

curl -X POST https://itextmaster.com/api/external/invoice-generator/pdf \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "invoiceNumber": "INV-001",
    "from": { "name": "Your Company", "email": "you@example.com" },
    "billTo": { "name": "Client Name", "email": "client@example.com" },
    "items": [{ "description": "Consulting", "quantity": 10, "rate": 150 }]
  }' \
  --output invoice.pdf

Node.js example

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

const response = await fetch('https://itextmaster.com/api/external/invoice-generator/pdf', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': process.env.ITEXTMASTER_API_KEY
  },
  body: JSON.stringify({
  invoiceNumber: 'INV-001',
  from: { name: 'Your Company', email: 'you@example.com' },
  billTo: { name: 'Client Name', email: 'client@example.com' },
  items: [{ description: 'Consulting', quantity: 10, rate: 150 }]
})
});

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

await writeFile('invoice.pdf', Buffer.from(await response.arrayBuffer()));

Python example

import os
import requests

response = requests.post(
    'https://itextmaster.com/api/external/invoice-generator/pdf',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': os.environ['ITEXTMASTER_API_KEY'],
    },
    json={
        'invoiceNumber': 'INV-001',
        'from': {'name': 'Your Company', 'email': 'you@example.com'},
        'billTo': {'name': 'Client Name', 'email': 'client@example.com'},
        'items': [{'description': 'Consulting', 'quantity': 10, 'rate': 150}],
    },
)
response.raise_for_status()

with open('invoice.pdf', 'wb') as f:
    f.write(response.content)

Error codes

400invalid_invoice_payload

بيانات الفاتورة JSON غير صحيحة أو تفتقد حقولًا مطلوبة.

401invalid_api_key

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

402insufficient_credits

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

500invoice_pdf_generation_failed

فشل إنشاء PDF الفاتورة. يتم رد Credits تلقائيًا عند الفشل.

Limits

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

Response headers

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

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

FAQ

كم تكلفة إنشاء فواتير 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 إنشاء فواتير PDF API, and buy more Credits only when automation volume grows.

Get API KeyView full API docs