Τεκμηρίωση API
Η πρόσβαση API απαιτεί ενεργή συνδρομή Pro ή Premium. Πιστοποιηθείτε με κλειδί API και ανεβάστε εικόνες στην ίδια βιβλιοθήκη με το Dashboard. Τα όρια αντιστοιχούν στο επί πληρωμή πρόγραμμα στον ιστότοπο.
Ανέβασμα εικόνας
POST /api/v1/upload με multipart/form-data.
Παράμετροι
Authorization- Υποχρεωτικό. Κεφαλίδα αιτήματος. Μορφή: Bearer ΤΟ_ΚΛΕΙΔΙ_API_ΣΑΣ.
file- Υποχρεωτικό. Ένα δυαδικό αρχείο ή δεδομένα base64.
name- Προαιρετικό. Όνομα αρχείου· ανιχνεύεται αυτόματα σε τοπικό multipart upload.
Παράδειγμα αιτήματος
Δυαδικό αρχείο
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- Id πόρου στη βιβλιοθήκη σας.
url- URL CDN για σελίδες προϊόντων.
fileName- Αρχικό όνομα αρχείου.
fileSize- Μέγεθος αρχείου σε byte.
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"
}