फोटो से URL लोगो

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