Λογότυπο Φωτο σε URL

Τεκμηρίωση 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"
}