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

हमारे RESTful API के साथ अपने एप्लिकेशन में शक्तिशाली फ़ाइल रूपांतरण को एकीकृत करें

bolt

बिजली की तेजी

अनुकूलित प्रसंस्करण के साथ उच्च प्रदर्शन रूपांतरण

shield

सुरक्षित एवं विश्वसनीय

99.9% अपटाइम के साथ एंटरप्राइज़-ग्रेड सुरक्षा

trending_up

स्केलेबल

प्रोटोटाइप से लेकर उत्पादन तक, हम आपके साथ स्केल करते हैं

terminalशुरू करना

1converter एपीआई का उपयोग करने के लिए, इन सरल चरणों का पालन करें:

  1. 1converter.com पर निःशुल्क खाते के लिए साइन अप करें
  2. अपने डैशबोर्ड से एक एपीआई कुंजी उत्पन्न करें
  3. अपनी एपीआई कुंजी के साथ एपीआई अनुरोध करना प्रारंभ करें

keyप्रमाणीकरण

सभी एपीआई अनुरोधों में प्राधिकरण शीर्षलेख में आपकी एपीआई कुंजी शामिल होनी चाहिए:

X-API-Key: YOUR_API_KEY Authorization: Bearer YOUR_API_KEY

ध्यान दें: कभी भी अपनी एपीआई कुंजी साझा न करें या इसे संस्करण नियंत्रण के लिए प्रतिबद्ध न करें।

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

आधार यूआरएल

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

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

OpenAPI 3.1 specification (JSON)

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

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

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

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

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

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

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 एक्सेस के लिए पेड प्लान आवश्यक है:

योजनादर सीमा
मुक्तउपलब्ध नहीं — अपग्रेड आवश्यक
स्टार्टर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"

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

यदि आपके कोई प्रश्न हैं या एपीआई के संबंध में सहायता की आवश्यकता है, तो हम सहायता के लिए यहां हैं!