Use case · PDF generation API

Dynamic business document-এর জন্য PDF Generation API

PDF generator খুঁজছেন? gPdf হলো developer-দের জন্য JSON-to-PDF API, যারা label, invoice, report এবং archived document-এর automated, batch PDF generation চান।

কাজটি কী

Business data-কে application-এর ভিতর থেকে স্বয়ংক্রিয়ভাবে production PDF-এ রূপান্তর করুন: shipping label, invoice, report, certificate এবং customer-facing document JSON থেকে generate হবে, user-কে online PDF generator-এ file manually upload করতে হবে না।

কখন fit করে

  • JSON-to-PDF generation: এক structured DocumentRequest-এ page, text, image, table, barcode এবং metadata define করুন।
  • API-first workflow: আপনার backend, job runner, warehouse system বা SaaS product থেকে POST /api/v1/pdf/render call করুন।
  • Batch-ready rendering: browser fleet manage না করেই হাজার, লাখ বা আরও বেশি PDF generate করুন।
  • Latin, CJK, Arabic, Devanagari, Bengali, Thai এবং Cyrillic content-এর জন্য built-in font।
  • Logistics, ecommerce এবং inventory document-এর জন্য vector barcode ও fixed-size label।
  • Generated document archival বা compliance handling চাইলে PDF/A, metadata এবং e-invoice option।

Sample request

POST /api/v1/pdf/render — JSON থেকে তৈরি minimal dynamic PDF।

{
  "pages": [
    {
      "size": "a4",
      "elements": [
        {
          "type": "text",
          "x": 24,
          "y": 28,
          "content": "Order #A-10042",
          "style": {
            "font_size": 18,
            "font_family": "NotoSans-Regular"
          }
        },
        {
          "type": "text",
          "x": 24,
          "y": 44,
          "content": "Generated automatically from application data.",
          "style": {
            "font_size": 10,
            "font_family": "NotoSans-Regular"
          }
        },
        {
          "type": "barcode",
          "format": "code128",
          "content": "A-10042",
          "x": 24,
          "y": 70,
          "width": 80,
          "height": 18
        }
      ]
    }
  ]
}

Compliance note

  • Generated PDF archive বা audit evidence-এ রাখতে হলে PDF/A profile available।
  • Generated PDF-এ stable title, author, subject এবং language রাখতে একই request-এ document metadata set করা যায়।
  • একই structured model API এবং https://studio.gpdf.com-এর visual editor দুটোতেই ব্যবহার করা যায়।

যদি শুধু one-off PDF generator দরকার হয়

Word document PDF-এ convert করা, দুইটি file merge করা, বা single page PDF হিসেবে export করার জন্য regular online PDF generator যথেষ্ট। এসব tool manual কাজের জন্য তৈরি: file upload, button click, result download।

gPdf অন্য কাজের জন্য। যেসব team চায় তাদের নিজস্ব software স্বয়ংক্রিয়ভাবে PDF generate করুক, gPdf তাদের জন্য।

যখন “PDF generator” আসলে “PDF generation API”

Search term broad, কিন্তু production requirement সাধারণত specific:

  1. Customer order দিলে আপনার system-কে shipping label generate করতে হয়।
  2. SaaS product-কে monthly statement বা report তৈরি করতে হয়।
  3. Finance workflow predictable metadata এবং archival setting-সহ invoice চায়।
  4. Warehouse system-কে carrier pickup-এর আগে 50,000 label দরকার।
  5. Support tool branded PDF receipt, certificate বা export চায়।

এই সব ক্ষেত্রে key question হলো না “কোন button PDF বানায়?” প্রশ্ন হলো: আপনার backend কি data থেকে সঠিক PDF বারবার, দ্রুত এবং কম predictable cost-এ generate করতে পারে?

gPdf model: JSON in, PDF out

gPdf structured JSON document model ব্যবহার করে। আপনার application পাঠায়:

  • page size এবং layout coordinate,
  • text block এবং font choice,
  • image এবং vector barcode,
  • table, metadata এবং document setting,
  • optional PDF/A বা e-invoice configuration।

API একটি PDF return করে। Browser server warm রাখা, Chromium version pin করা, বা hot path-এ HTML/CSS layout engine চালানোর দরকার নেই।

Batch generation-এ এটি কেন গুরুত্বপূর্ণ

Generic PDF generator tool একজন মানুষের জন্য convenient। সারাদিন document তৈরি করা system-এর জন্য এগুলো তৈরি নয়।

Batch generation-এ গুরুত্বপূর্ণ property হলো:

  • reprint ও audit trail-এর জন্য deterministic output,
  • queue spike হলে low p99 latency,
  • generated page প্রতি predictable cost,
  • container image বদলালেও font ও barcode geometry stable থাকা,
  • developer version ও test করতে পারে এমন request shape।

gPdf এই workload target করে।

Simple API call দিয়ে শুরু করুন

Code wire করার আগে JSON model দেখতে চাইলে playground খুলুন। Integrate করতে প্রস্তুত হলে JSON Render API reference ব্যবহার করুন এবং আপনার backend থেকে একই request পাঠান।

প্রথম workload যদি logistics হয়, তাহলে shipping-label use case পড়ুন। সেখানে একই pattern 4×6 thermal label, carrier barcode এবং peak-volume generation-এ কীভাবে প্রযোজ্য তা দেখানো হয়েছে।

FAQ

gPdf কি online PDF generator?
Consumer upload-and-convert অর্থে নয়। gPdf হলো product, backend এবং operational system-এর ভিতরে automated PDF generation-এর জন্য developer API।
JSON থেকে dynamic PDF generate করতে পারি?
হ্যাঁ। DocumentRequest page, text, image, barcode, table, metadata এবং setting describe করে। আপনার application JSON পাঠায় এবং PDF পায়।
Headless browser-এর বদলে কখন gPdf ব্যবহার করব?
Document structured, repeated এবং high-volume হলে gPdf ব্যবহার করুন: label, invoice, report, certificate এবং generated business document। Arbitrary HTML screenshot-এর জন্য browser rendering এখনও useful।
Non-developer কি PDF design করতে পারে?
হ্যাঁ। https://studio.gpdf.com-এর visual editor একই JSON model নিয়ে কাজ করে, তাই operations বা design teammate layout adjust করতে পারে আর developer API workflow রাখে।