Logo Photo To URL

Documentation API

L’accès API nécessite un abonnement Pro ou Premium actif. Authentifiez-vous avec une clé API, puis téléversez des images dans la même bibliothèque que le tableau de bord. Les quotas correspondent à votre abonnement payant sur le site.

Images produit

Téléverser une image

POST /api/v1/upload en multipart/form-data.

Paramètres

Authorization
Obligatoire. En-tête de requête. Format : Bearer VOTRE_CLE_API.
file
Obligatoire. Un fichier binaire ou des données base64.
name
Facultatif. Nom de fichier ; détecté automatiquement pour un fichier local en multipart.

Exemple d’appel

Fichier binaire

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"

Utilisez toujours POST pour un fichier local. Les envois en GET ne sont pas pris en charge.

Champs de réponse

id
Id de la ressource dans votre bibliothèque.
url
URL CDN utilisable sur les pages produit.
fileName
Nom de fichier d’origine.
fileSize
Taille du fichier en octets.
mimeType
Type MIME du fichier téléversé.
createdAt
Heure de téléversement en UTC, format 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"
}

Lister les images

GET /api/v1/images avec page et pageSize optionnels (max 100).

curl "https://phototourl.com/api/v1/images?page=1&pageSize=20" \
  -H "Authorization: Bearer ptu_live_YOUR_KEY"

Champs de réponse

resources
Tableau d’images : id, fileName, url, fileSize, mimeType, createdAt.
page
Numéro de page actuel.
pageSize
Éléments par page.
total
Nombre total d’images dans la bibliothèque.
{
  "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
}

Supprimer une image

DELETE /api/v1/images/:id. Supprime le fichier du stockage et de votre bibliothèque.

curl -X DELETE https://phototourl.com/api/v1/images/RESOURCE_ID \
  -H "Authorization: Bearer ptu_live_YOUR_KEY"

Champs de réponse

success
true lorsque l’image a été supprimée.
{ "success": true }

Limites

L’API n’est pas dispo en Free. Pro et Premium utilisent les limites de téléversement, de stockage et de taille de fichier de votre abonnement. En cas de dépassement, l’API renvoie une erreur avec upgradeUrl.

Erreurs

Les requêtes échouées renvoient un code d’erreur. Les erreurs de quota peuvent inclure upgradeUrl.

  • dailyLimitReached— Limite de téléversements quotidienne atteinte (HTTP 429).
  • storageLimitReached— Quota de stockage dépassé (HTTP 413).
  • fileTooLarge— Fichier plus grand que ce que permet votre abonnement (HTTP 400).
  • 401— Clé API manquante, invalide ou révoquée.
{
  "error": "dailyLimitReached",
  "errorParams": { "limit": 1000 },
  "plan": "paid",
  "limit": 1000,
  "upgradeUrl": "https://www.phototourl.com/pricing"
}