תיעוד 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"
}