API को PDF Base64 में कैसे भेजें
ई-इनवॉइस, ई-सिग्नेचर या शिपिंग API डॉक्यूमेंट को JSON फ़ील्ड में माँगता है। यहाँ जानें कि PDF को सही तरह के टेक्स्ट में कैसे बदलें, उसे कैसे जाँचें और उन ग़लतियों से कैसे बचें जिनसे रिक्वेस्ट फ़ेल हो जाती है।
लेखक: Metin Ersoy · अपडेट: 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 खोलें