API दस्तावेज़
API के लिए सक्रिय Pro या Premium सदस्यता चाहिए। API कुंजी से प्रमाणित करें, फिर डैशबोर्ड जैसी ही लाइब्रेरी में चित्र अपलोड करें। कोटा वेबसाइट के सशुल्क प्लान से मेल खाते हैं।
प्रमाणीकरण
Authorization हेडर में अपनी कुंजी भेजें। सेटिंग्स → API कुंजियाँ में बनाएँ। पूरी कुंजी केवल एक बार दिखती है।
Authorization: Bearer ptu_live_xxxxxxxx
चित्र अपलोड करें
multipart फ़ॉर्म फ़ील्ड file को /api/v1/images पर POST करें।
curl -X POST https://www.phototourl.com/api/v1/images \ -H "Authorization: Bearer ptu_live_YOUR_KEY" \ -F "file=@./product.jpg"
रिस्पॉन्स फ़ील्ड
id- लाइब्रेरी में संसाधन id।
url- उत्पाद पृष्ठ पर उपयोग योग्य CDN URL।
storage- स्टोरेज बैकएंड पहचानकर्ता (वर्तमान में r2)।
plan- इस अपलोड के लिए खाता प्लान (paid)।
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",
"storage": "r2",
"plan": "paid",
"createdAt": "2026-11-05 10:20:30"
}चित्र सूची
GET /api/v1/images — वैकल्पिक page और pageSize (अधिकतम 100)।
curl "https://www.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://www.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"
}