PDFVela — pdfvela.com
सभी PDF टूल

API को PDF Base64 में कैसे भेजें

ई-इनवॉइस, ई-सिग्नेचर या शिपिंग API डॉक्यूमेंट को JSON फ़ील्ड में माँगता है। यहाँ जानें कि PDF को सही तरह के टेक्स्ट में कैसे बदलें, उसे कैसे जाँचें और उन ग़लतियों से कैसे बचें जिनसे रिक्वेस्ट फ़ेल हो जाती है।

लेखक: · अपडेट: 10 नवंबर 2026

API आमतौर पर क्या चाहता है

ज़्यादातर डॉक्यूमेंट API एक JSON बॉडी बताते हैं, जिसमें content, file, data या document नाम का फ़ील्ड होता है। इसकी वैल्यू PDF का Base64 कोड होती है, अक्सर फ़ाइल के नाम और टाइप के साथ:

{
  "fileName": "invoice-1024.pdf",
  "mimeType": "application/pdf",
  "content": "JVBERi0xLjcKJ..."
}

कोड लिखने से पहले डॉक्यूमेंटेशन में तीन बातें देख लें: फ़ील्ड का नाम, data: प्रीफ़िक्स चाहिए या नहीं (आमतौर पर नहीं), और साइज़ की सीमा।

1. PDF को Base64 में बदलें

टेस्ट वैल्यू पाने का सबसे तेज़ तरीक़ा है PDF से Base64। PDF चुनें, सिर्फ़ Base64 कोड (JVBERi0 से शुरू होता है) चुनें और नतीजा कॉपी कर लें। अगर आपको शुरुआत के लिए पूरी रिक्वेस्ट बॉडी चाहिए, तो इसकी जगह फ़ाइल के नाम, टाइप और कंटेंट के साथ JSON चुनें — इसमें फ़ाइल का नाम और टाइप अपने-आप जुड़ जाते हैं। PDF आपके ब्राउज़र में ही बदलती है और अपलोड नहीं होती, जो तब बहुत मायने रखता है जब टेस्ट डॉक्यूमेंट कोई असली इनवॉइस हो।

नतीजा जाँच लें: यह JVBERi0 से शुरू होना चाहिए, इसमें कोई स्पेस नहीं होना चाहिए, और आख़िर के एक-दो = चिह्नों के अलावा इसमें सिर्फ़ अक्षर, अंक, + और / होने चाहिए।

2. अपने कोड से भेजें

तीन आम भाषाओं में यही स्टेप। हर उदाहरण फ़ाइल पढ़ता है, उसे एन्कोड करता है और JSON भेजता है:

# curl (Linux / macOS): base64 -w 0 keeps it on one line
curl -X POST https://api.example.com/documents \
  -H "Content-Type: application/json" \
  -d "{\"fileName\":\"invoice.pdf\",\"content\":\"$(base64 -w 0 invoice.pdf)\"}"
// Node.js 18+
import { readFile } from 'node:fs/promises';
const content = (await readFile('invoice.pdf')).toString('base64');
await fetch('https://api.example.com/documents', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ fileName: 'invoice.pdf', content }),
});
# Python 3 with requests
import base64, requests
with open("invoice.pdf", "rb") as f:
    content = base64.b64encode(f.read()).decode("ascii")
requests.post("https://api.example.com/documents",
              json={"fileName": "invoice.pdf", "content": content})

macOS पर curl वाली लाइन में -w 0 की जगह base64 -i invoice.pdf इस्तेमाल होता है। पता और फ़ील्ड के नाम सिर्फ़ उदाहरण हैं; अपनी सर्विस के डॉक्यूमेंटेशन वाले नाम इस्तेमाल करें।

3. वापसी में भी जाँचें

अगर सर्विस डॉक्यूमेंट या उसकी सेव की गई कॉपी Base64 में लौटाती है, तो वह जवाब Base64 से PDF में पेस्ट करें। पहला पेज और पेजों की गिनती देख लेना इस बात का सबसे तेज़ सबूत है कि रास्ते में कुछ नहीं खोया। इस दिशा के पूरे स्टेप Base64 स्ट्रिंग को PDF फ़ाइल के रूप में कैसे सेव करें में हैं।

आम ग़लतियाँ

समस्यासंभावित वजहहल
"Invalid Base64"लाइन ब्रेक (76 कैरेक्टर की लाइनें) या data: प्रीफ़िक्सएक ही लाइन में सिर्फ़ कोड भेजें
"Payload too large" (413)एन्कोड होने के बाद PDF बहुत बड़ी हो गईPDF कंप्रेस करें से इसे छोटा करें
PDF ख़ाली या टूटी हुई खुलती हैस्ट्रिंग बीच में कट गईदोबारा एन्कोड करें और पूरी वैल्यू भेजें
ख़ास अक्षरों वाले नाम गड़बड़ दिखते हैंफ़ाइल का नाम ग़लत एन्कोडिंग में भेजा गयाJSON बॉडी को UTF-8 में रखें

आज़माने के लिए तैयार हैं? यह मुफ़्त है और आपकी फ़ाइल आपके डिवाइस पर ही रहती है।

PDF से Base64 खोलें

PDF को Base64 में भेजने से जुड़े सवाल

API को फ़ाइल की जगह Base64 क्यों चाहिए?

JSON सिर्फ़ टेक्स्ट ले जा सकता है। Base64 PDF के बाइट्स को अक्षरों, अंकों, + और / से लिखता है, इसलिए पूरा डॉक्यूमेंट बाक़ी डेटा, जैसे कस्टमर नंबर या इनवॉइस की तारीख़, के बगल में एक ही स्ट्रिंग फ़ील्ड में आ जाता है।

क्या मुझे data:application/pdf;base64, प्रीफ़िक्स भी भेजना चाहिए?

आमतौर पर नहीं। ज़्यादातर API सिर्फ़ कोड चाहते हैं, जो JVBERi0 से शुरू होता है। Data URI तभी भेजें जब डॉक्यूमेंटेशन में वही दिखाया गया हो, या जब ब्राउज़र को URL चाहिए, जैसे किसी iframe में।

API कहता है कि Base64 ग़लत है। इसकी सबसे आम वजह क्या है?

स्ट्रिंग में लाइन ब्रेक या प्रीफ़िक्स, या पेस्ट करते समय कट गया कोड। एक ही लाइन में सिर्फ़ कोड भेजें और जाँच लें कि स्ट्रिंग का आख़िरी हिस्सा पूरा पहुँचा है।

PDF कितनी बड़ी हो सकती है?

यह सर्विस पर निर्भर करता है, लेकिन टेक्स्ट फ़ाइल से लगभग एक-तिहाई बड़ा होता है, यानी 3 MB की PDF लगभग 4 MB का JSON बन जाती है। कई API कुछ मेगाबाइट पर ही रुक जाते हैं; सबसे आसान हल है पहले PDF को कंप्रेस करना।

क्या Base64 एक तरह का एन्क्रिप्शन है?

नहीं। जिसके पास भी कोड है, वह उसे वापस डॉक्यूमेंट में बदल सकता है। इसे सिर्फ़ HTTPS पर भेजें और किसी गोपनीय PDF को ऐसी वेबसाइट में कभी पेस्ट न करें जो उसे अपलोड करती हो।