Documentation API
L’accès API nécessite un abonnement Pro ou Premium actif. Authentifiez-vous avec une clé API, puis envoyez des images dans la même bibliothèque que le tableau de bord. Les quotas correspondent à votre offre payante sur le site.
Envoyer 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 envoyé.
createdAt- Heure d’envoi 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 d’envoi, de stockage et de taille de fichier de votre offre. 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 d’envois quotidienne atteinte (HTTP 429).storageLimitReached— Quota de stockage dépassé (HTTP 413).fileTooLarge— Fichier plus grand que ce que permet votre offre (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"
}