Documentation API
L’accès API nécessite un forfait 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 forfait payant sur le site.
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 produits.
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 disponible en Free. Pro et Premium utilisent les limites de téléversement, de stockage et de taille de fichier de votre forfait. 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 forfait (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"
}