API दस्तावेज़
API के लिए सक्रिय Pro या Premium सदस्यता चाहिए। API कुंजी से प्रमाणित करें, फिर डैशबोर्ड जैसी ही लाइब्रेरी में चित्र अपलोड करें। कोटा वेबसाइट के सशुल्क प्लान से मेल खाते हैं।
चित्र अपलोड करें
POST /api/v1/upload (multipart/form-data)।
पैरामीटर
Authorization- आवश्यक। अनुरोध हेडर। प्रारूप: Bearer आपकी_API_कुंजी।
file- आवश्यक। बाइनरी फ़ाइल या base64 डेटा।
name- वैकल्पिक। फ़ाइल नाम; स्थानीय multipart अपलोड पर स्वतः पहचाना जाता है।
उदाहरण अनुरोध
बाइनरी फ़ाइल
curl https://phototourl.com/api/v1/upload \ -X POST \ -H "Authorization: Bearer ptu_live_YOUR_KEY" \ -F "file=@./product.jpg"
Base64
curl https://phototourl.com/api/v1/upload \ -X POST \ -H "Authorization: Bearer ptu_live_YOUR_KEY" \ -F "file=R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7" \ -F "name=pixel.gif"
स्थानीय फ़ाइल अपलोड करते समय हमेशा POST उपयोग करें। GET समर्थित नहीं है।
रिस्पॉन्स फ़ील्ड
id- लाइब्रेरी में संसाधन id।
url- उत्पाद पृष्ठ पर उपयोग योग्य CDN URL।
fileName- मूल फ़ाइल नाम।
fileSize- फ़ाइल आकार (बाइट में)।
mimeType- अपलोड की गई फ़ाइल का MIME प्रकार।
createdAt- UTC में अपलोड समय, प्रारूप YYYY-MM-DD HH:mm:ss।
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"url": "https://cdn.phototourl.com/pro/2026-11-05-a1b2c3d4-e5f6-7890-abcd-ef1234567890.jpg",
"fileName": "product.jpg",
"fileSize": 128472,
"mimeType": "image/jpeg",
"createdAt": "2026-11-05 10:20:30"
}चित्र सूची
GET /api/v1/images — वैकल्पिक page और pageSize (अधिकतम 100)।
curl "https://phototourl.com/api/v1/images?page=1&pageSize=20" \ -H "Authorization: Bearer ptu_live_YOUR_KEY"
रिस्पॉन्स फ़ील्ड
resources- चित्रों की सूची: id, fileName, url, fileSize, mimeType, createdAt।
page- वर्तमान पृष्ठ संख्या।
pageSize- प्रति पृष्ठ आइटम।
total- लाइब्रेरी में कुल चित्र।
{
"resources": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"fileName": "product.jpg",
"url": "https://cdn.phototourl.com/pro/2026-11-05-a1b2c3d4-e5f6-7890-abcd-ef1234567890.jpg",
"fileSize": 128472,
"mimeType": "image/jpeg",
"createdAt": "2026-11-05 10:20:30"
}
],
"page": 1,
"pageSize": 20,
"total": 1
}चित्र हटाएँ
DELETE /api/v1/images/:id। स्टोरेज और लाइब्रेरी से फ़ाइल हटाता है।
curl -X DELETE https://phototourl.com/api/v1/images/RESOURCE_ID \ -H "Authorization: Bearer ptu_live_YOUR_KEY"
रिस्पॉन्स फ़ील्ड
success- हटाने पर true।
{ "success": true }सीमाएँ
निःशुल्क पर API उपलब्ध नहीं। Pro और Premium आपके प्लान की अपलोड, स्टोरेज और फ़ाइल-आकार सीमाएँ लागू करते हैं। सीमा पार पर API upgradeUrl के साथ त्रुटि लौटा सकता है।
त्रुटियाँ
असफल अनुरोध त्रुटि कोड लौटाते हैं। कोटा त्रुटियों में upgradeUrl हो सकता है।
dailyLimitReached— दैनिक अपलोड सीमा पूरी (HTTP 429)।storageLimitReached— स्टोरेज कोटा पार (HTTP 413)।fileTooLarge— फ़ाइल प्लान से बड़ी (HTTP 400)।401— API कुंजी गायब, अमान्य या रद्द।
{
"error": "dailyLimitReached",
"errorParams": { "limit": 1000 },
"plan": "paid",
"limit": 1000,
"upgradeUrl": "https://www.phototourl.com/pricing"
}