Documentación de la API
El acceso a la API requiere una suscripción Pro o Premium activa. Autentícate con una clave API y sube imágenes a la misma biblioteca del Dashboard. Las cuotas coinciden con tu plan de pago en el sitio.
Subir una imagen
POST /api/v1/upload con multipart/form-data.
Parámetros
Authorization- Obligatorio. Cabecera de petición. Formato: Bearer TU_CLAVE_API.
file- Obligatorio. Un archivo binario o datos en base64.
name- Opcional. Nombre de archivo; se detecta solo al subir un archivo local por multipart.
Ejemplo de llamada
Archivo binario
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"
Usa siempre POST para archivos locales. No se admite subir con GET.
Campos de respuesta
id- Id del recurso en tu biblioteca.
url- URL CDN que puedes usar en páginas de producto.
fileName- Nombre de archivo original.
fileSize- Tamaño del archivo en bytes.
mimeType- Tipo MIME del archivo subido.
createdAt- Hora de subida en UTC, formato 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"
}Listar imágenes
GET /api/v1/images con page y pageSize opcionales (máx. 100).
curl "https://phototourl.com/api/v1/images?page=1&pageSize=20" \ -H "Authorization: Bearer ptu_live_YOUR_KEY"
Campos de respuesta
resources- Array de imágenes: id, fileName, url, fileSize, mimeType, createdAt.
page- Número de página actual.
pageSize- Elementos por página.
total- Total de imágenes en la biblioteca.
{
"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
}Eliminar una imagen
DELETE /api/v1/images/:id. Elimina el archivo del almacenamiento y de tu biblioteca.
curl -X DELETE https://phototourl.com/api/v1/images/RESOURCE_ID \ -H "Authorization: Bearer ptu_live_YOUR_KEY"
Campos de respuesta
success- true cuando la imagen se eliminó.
{ "success": true }Límites
La API no está disponible en Free. Pro y Premium usan los límites de subida, almacenamiento y tamaño de archivo de tu plan. Si superas un límite, la API devuelve un error con upgradeUrl.
Errores
Las solicitudes fallidas devuelven un código de error. Los errores de cuota pueden incluir upgradeUrl.
dailyLimitReached— Límite diario de subidas alcanzado (HTTP 429).storageLimitReached— Cuota de almacenamiento superada (HTTP 413).fileTooLarge— Archivo mayor de lo que permite tu plan (HTTP 400).401— Clave API ausente, inválida o revocada.
{
"error": "dailyLimitReached",
"errorParams": { "limit": 1000 },
"plan": "paid",
"limit": 1000,
"upgradeUrl": "https://www.phototourl.com/pricing"
}