फोटो से URL लोगो

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