প্রোডাকশন সিস্টেমের জন্য ব্যাচ PDF জেনারেশন API
batch PDF generation structured backend data থেকে browser ছাড়া render করুন. gPdf PDF output সামলায় এবং business rules আপনার system-এ থাকে.
/api/v1/template-render batch PDF generation structured data থেকে repeatable PDF হিসেবে generate করা. gPdf document render করে; data semantics এবং workflow state থাকে আপনার system-এ.
কখন এই API ব্যবহার করবেন
- Backend-এ batch PDF generation data আগে থেকেই আছে এবং stable PDF response দরকার.
- Operational document-এর জন্য Chromium বা HTML-to-PDF avoid করতে চান.
- Reprint, audit বা batch-এর জন্য repeatable output দরকার.
এটি কী replace করে না
- gPdf postage কেনা, tax filing, external order তৈরি বা fiscal system হিসেবে কাজ করে না.
- Data validation, business rules বা marketplace integrations replace করে না.
কোন endpoint call করবেন
/api/v1/template-render
Template Render এই workflow-এর default path.
/api/v1/pdf/render
Workflow-তে related API path, template contract অথবা capabilities lookup দরকার হলে ব্যবহার করুন.
Minimal request
/api/v1/template-render - batch PDF generation
{
"template_id": "invoice",
"data": [
{
"invoice_number": "INV-2026-101",
"date_of_issue": "2026-05-29",
"bill_to_name": "Buyer A",
"subtotal": "$50.00",
"total": "$50.00",
"amount_due": "$50.00",
"items": []
},
{
"invoice_number": "INV-2026-102",
"date_of_issue": "2026-05-29",
"bill_to_name": "Buyer B",
"subtotal": "$75.00",
"total": "$75.00",
"amount_due": "$75.00",
"items": []
}
]
}
gPdf কী handle করে
- Structured request থেকে batch PDF generation PDF rendering.
- Request অনুযায়ী text, tables, lines, barcodes, pages, metadata এবং output options.
- Retry, reprint এবং audit-এর জন্য deterministic output.
আপনার system কী own করে
- batch PDF generation-এর সঠিক data, business rules এবং operation state.
- Authentication, storage, external workflows এবং receiver validation.
Production checklist
- Real data এবং PDF consume করা systems দিয়ে test করুন.
- Support, audit এবং reprint-এর জন্য request IDs এবং validation evidence রাখুন.
- Approved layout একাধিক system reuse করলে template করুন.
Claim boundaries
- gPdf request থেকে PDF render করে; product workflow, database বা business validation replace করে না.
- Data semantics, retries, storage এবং final acceptance আপনার system-এ থাকে.
API shape
ব্যাচ PDF জেনারেশন API public gPdf APIs-এর ওপর তৈরি production workflow. Request data, layout, settings এবং render হওয়া PDF parts স্পষ্ট করে. gPdf PDF বানায়; business event-এর meaning আপনার system রাখে.
Endpoint choice
এই workflow-এর default endpoint /api/v1/template-render. Layout approve হয়ে systems-এ reuse হলে Template Render ব্যবহার করুন. EN 16931 CII XML embedded Factur-X / ZUGFeRD PDF/A-3b packaging দরকার হলেই E-Invoice Render ব্যবহার করুন.
Production-এর আগে validation
batch PDF generation real data এবং downstream systems দিয়ে validate করুন. Support, audit এবং reprint-এর জন্য request IDs, rendered output এবং validation evidence রাখুন.
FAQ
- এটি কি আলাদা endpoint?
- ব্যাচ PDF জেনারেশন API workflow-কে public gPdf API path-এ map করে. Page বলে কোন path call করতে হবে এবং request কী own করে.
- Templates use করা যাবে?
- হ্যাঁ. Layout বদলালে JSON Render use করুন; layout approve হলে এবং callers শুধু business data পাঠালে Template Render use করুন.
- Production-এর আগে কী validate করবেন?
- Real data এবং workflow-এর printer, scanner, validator, accounting system বা marketplace receiver দিয়ে validate করুন.