Logotipo de Foto a URL

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.

Imágenes de producto

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"
}