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

תיעוד API

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

תמונות מוצר

העלאת תמונה

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