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