एपीआई दस्तावेज़ीकरण

अपने कोड से फ़ाइलें कन्वर्ट करें: फ़ाइल अपलोड करें, स्टेटस देखें, नतीजा डाउनलोड करें। तीन रिक्वेस्ट और एक API कुंजी।

एपीआई कुंजी प्राप्त करेंशुरू हो जाओ
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"

शुरू करना

शुरुआत से पहली कन्वर्ट हुई फ़ाइल तक:

  1. 1-converter.com पर कोई पेड प्लान (Starter, Pro या Business) चुनें। Free पर API कुंजी नहीं मिलती।
  2. डैशबोर्ड → सेटिंग्स → API कुंजियाँ में नई कुंजी बनाएँ और कॉपी करें: यह सिर्फ़ एक बार दिखती है।
  3. पहले अपलोड के साथ की भेजें, जैसा ऑथेंटिकेशन में दिखाया गया है।

प्रमाणीकरण

हर अनुरोध के साथ अपनी API कुंजी भेजें, इन दो हेडर में से किसी एक में:

X-API-Key: YOUR_API_KEY

Authorization: Bearer YOUR_API_KEY

दोनों हेडर मान्य हैं और दोनों में एक ही कुंजी जाती है, जो आपके HTTP क्लाइंट के लिए आसान हो, वही इस्तेमाल करें।

अपनी API कुंजी कभी किसी से शेयर न करें और उसे वर्ज़न कंट्रोल में कमिट न करें।

अपनी एपीआई कुंजी को सुरक्षित रखें और इसे क्लाइंट-साइड कोड में कभी भी उजागर न करें।

आधार यूआरएल

सभी एपीआई अनुरोध यहां किए जाने चाहिए:

https://api.1-converter.com/api/v1

OpenAPI 3.1 (openapi.json)

एपीआई समापन बिंदु

अपलोड करें और कनवर्ट करें

एक फ़ाइल अपलोड करें और इसे निर्दिष्ट प्रारूप में परिवर्तित करें

POST/api/v1/convert/upload

शीर्षलेखों का अनुरोध करें

Content-Type: multipart/form-data
Authorization: Bearer YOUR_API_KEY

अनुरोध का मुख्य भाग

  • fileकनवर्ट की जाने वाली फ़ाइल (आवश्यक)
  • target_formatलक्ष्य प्रारूप (जैसे '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"
}

स्थिति जाँचिए

रूपांतरण की स्थिति जांचें

GET/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"
  }
}

परिणाम डाउनलोड करें

परिवर्तित फ़ाइल डाउनलोड करें

GET/api/v1/convert/download/:id

दर सीमाएँ

हर पेड प्लान में हर महीने तय संख्या में API कॉल मिलती हैं, वही जो प्राइसिंग पेज पर दिखाई गई हैं।

योजनाहर महीने API कॉल
FreeAPI कुंजी नहीं
Starterहर महीने 1,000 API कॉल
Proहर महीने 10,000 API कॉल
Businessअसीमित API

जब दर सीमा पार हो जाती है, तो आपको 429 बहुत अधिक अनुरोधों का जवाब प्राप्त होगा।

त्रुटि कोड

एपीआई सफलता या विफलता को इंगित करने के लिए मानक HTTP स्थिति कोड का उपयोग करता है:

कोडविवरण
400 ख़राब अनुरोधअमान्य अनुरोध पैरामीटर
अनधिकृत 401अमान्य या अनुपलब्ध API कुंजी
403 निषिद्धअपर्याप्त अनुमतियाँ
404 नहीं मिलासंसाधन नहीं मिला
429 बहुत अधिक अनुरोधदर सीमा पार हो गई
500 आंतरिक सर्वर त्रुटिसर्वर त्रुटि, कृपया पुनः प्रयास करें

कोड उदाहरण

यहां विभिन्न प्रोग्रामिंग भाषाओं में उदाहरण दिए गए हैं:

जावास्क्रिप्ट (नोड.जेएस)

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"

मदद की ज़रूरत है?

कोई रिक्वेस्ट ऐसे फ़ेल हो रही है जिसकी वजह इस डॉक्यूमेंटेशन में नहीं है? रिक्वेस्ट और मिला हुआ जवाब हमें भेजें।

समर्थन से संपर्क करेंएपीआई कुंजी प्रबंधित करें