לוגו תמונה ל-URL

תיעוד API

גישת API דורשת מנוי Pro או Premium פעיל. הזדהו עם מפתח API והעלו תמונות לאותה ספרייה כמו ב־Dashboard. המכסות תואמות לתוכנית בתשלום באתר.

תמונות מוצר

אימות

שלחו את המפתח בכותרת Authorization. צרו מפתחות תחת הגדרות → מפתחות API. המפתח המלא מוצג פעם אחת בלבד.

Authorization: Bearer ptu_live_xxxxxxxx

העלאת תמונה

POST של שדה multipart בשם file אל /api/v1/images.

curl -X POST https://www.phototourl.com/api/v1/images \
  -H "Authorization: Bearer ptu_live_YOUR_KEY" \
  -F "file=@./product.jpg"

שדות תגובה

id
מזהה המשאב בספרייה שלכם.
url
כתובת CDN לשימוש בדפי מוצר.
storage
מזהה backend האחסון (כרגע 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 אינו זמין ב־Free. 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"
}