Developer workflows

প্রোডাকশন সিস্টেমের জন্য ব্যাচ PDF জেনারেশন API

batch PDF generation structured backend data থেকে browser ছাড়া render করুন. gPdf PDF output সামলায় এবং business rules আপনার system-এ থাকে.

PRIMARY API Template Render
ENDPOINT /api/v1/template-render
SYSTEMS operations backend / finance system / compliance workflow / document service
যে কাজটি করতে হবে

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 করবেন

PRIMARY

/api/v1/template-render

Template Render এই workflow-এর default path.

SECONDARY 1

/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

  1. Real data এবং PDF consume করা systems দিয়ে test করুন.
  2. Support, audit এবং reprint-এর জন্য request IDs এবং validation evidence রাখুন.
  3. 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 করুন.