एपीआई दस्तावेज़ीकरण
हमारे RESTful API के साथ अपने एप्लिकेशन में शक्तिशाली फ़ाइल रूपांतरण को एकीकृत करें
बिजली की तेजी
अनुकूलित प्रसंस्करण के साथ उच्च प्रदर्शन रूपांतरण
सुरक्षित एवं विश्वसनीय
99.9% अपटाइम के साथ एंटरप्राइज़-ग्रेड सुरक्षा
स्केलेबल
प्रोटोटाइप से लेकर उत्पादन तक, हम आपके साथ स्केल करते हैं
terminalशुरू करना
1converter एपीआई का उपयोग करने के लिए, इन सरल चरणों का पालन करें:
- 1converter.com पर निःशुल्क खाते के लिए साइन अप करें
- अपने डैशबोर्ड से एक एपीआई कुंजी उत्पन्न करें
- अपनी एपीआई कुंजी के साथ एपीआई अनुरोध करना प्रारंभ करें
keyप्रमाणीकरण
सभी एपीआई अनुरोधों में प्राधिकरण शीर्षलेख में आपकी एपीआई कुंजी शामिल होनी चाहिए:
X-API-Key: YOUR_API_KEY
Authorization: Bearer YOUR_API_KEYध्यान दें: कभी भी अपनी एपीआई कुंजी साझा न करें या इसे संस्करण नियंत्रण के लिए प्रतिबद्ध न करें।
अपनी एपीआई कुंजी को सुरक्षित रखें और इसे क्लाइंट-साइड कोड में कभी भी उजागर न करें।
आधार यूआरएल
सभी एपीआई अनुरोध यहां किए जाने चाहिए:
https://api.1-converter.com/api/v1codeएपीआई समापन बिंदु
अपलोड करें और कनवर्ट करें
एक फ़ाइल अपलोड करें और इसे निर्दिष्ट प्रारूप में परिवर्तित करें
/api/v1/convert/uploadशीर्षलेखों का अनुरोध करें
Content-Type: multipart/form-data
Authorization: Bearer YOUR_API_KEYअनुरोध का मुख्य भाग
कनवर्ट की जाने वाली फ़ाइल (आवश्यक)लक्ष्य प्रारूप (जैसे 'pdf', 'jpg', 'png') (आवश्यक)
प्रतिक्रिया
{
"id": 4821,
"original_file_name": "document.pdf",
"original_format": "pdf",
"target_format": "docx",
"status": "pending",
"progress": 0,
"created_at": "2026-08-01T09:14:03Z",
"expires_at": "2026-08-08T09:14:03Z"
}स्थिति जाँचिए
रूपांतरण की स्थिति जांचें
/api/v1/convert/status/:idप्रतिक्रिया
{
"conversion": {
"id": 4821,
"original_file_name": "document.pdf",
"target_format": "docx",
"status": "completed",
"progress": 100,
"created_at": "2026-08-01T09:14:03Z",
"expires_at": "2026-08-08T09:14:03Z"
}
}परिणाम डाउनलोड करें
परिवर्तित फ़ाइल डाउनलोड करें
/api/v1/convert/download/:idदर सीमाएँ
API अनुरोध प्रति मिनट सीमित हैं। API एक्सेस के लिए पेड प्लान आवश्यक है:
| योजना | दर सीमा |
|---|---|
| मुक्त | उपलब्ध नहीं — अपग्रेड आवश्यक |
| स्टार्टर | 5,000 अनुरोध/मिनट |
| प्रो | 5,000 अनुरोध/मिनट |
| व्यापार | असीमित |
जब दर सीमा पार हो जाती है, तो आपको 429 बहुत अधिक अनुरोधों का जवाब प्राप्त होगा।
त्रुटि कोड
एपीआई सफलता या विफलता को इंगित करने के लिए मानक HTTP स्थिति कोड का उपयोग करता है:
| कोड | विवरण |
|---|---|
| 400 ख़राब अनुरोध | अमान्य अनुरोध पैरामीटर |
| अनधिकृत 401 | अमान्य या अनुपलब्ध API कुंजी |
| 403 निषिद्ध | अपर्याप्त अनुमतियाँ |
| 404 नहीं मिला | संसाधन नहीं मिला |
| 429 बहुत अधिक अनुरोध | दर सीमा पार हो गई |
| 500 आंतरिक सर्वर त्रुटि | सर्वर त्रुटि, कृपया पुनः प्रयास करें |
integration_instructionsकोड उदाहरण
यहां विभिन्न प्रोग्रामिंग भाषाओं में उदाहरण दिए गए हैं:
जावास्क्रिप्ट (नोड.जेएस)
const FormData = require('form-data');
const fs = require('fs');
const axios = require('axios');
const formData = new FormData();
formData.append('file', fs.createReadStream('input.jpg'));
formData.append('target_format', 'png');
axios.post('https://api.1-converter.com/api/v1/convert/upload', formData, {
headers: {
...formData.getHeaders(),
'Authorization': 'Bearer YOUR_API_KEY'
}
}).then(response => {
console.log(response.data);
}).catch(error => {
console.error(error);
});अजगर
import requests
url = 'https://api.1-converter.com/api/v1/convert/upload'
headers = {'Authorization': 'Bearer YOUR_API_KEY'}
files = {'file': open('input.jpg', 'rb')}
data = {'target_format': 'png'}
response = requests.post(url, headers=headers, files=files, data=data)
print(response.json())कर्ल
curl -X POST https://api.1-converter.com/api/v1/convert/upload \ -H "X-API-Key: YOUR_API_KEY" \ -F "[email protected]" \ -F "target_format=png"
मदद की ज़रूरत है?
यदि आपके कोई प्रश्न हैं या एपीआई के संबंध में सहायता की आवश्यकता है, तो हम सहायता के लिए यहां हैं!