Show Menu
TEMAS×

Carga de recursos de imagen o recursos de vector

Para poder cargar un recurso de imagen, primero debe solicitar una clave secreta compartida. Esta clave permite recuperar un distintivo de carga. Este distintivo de carga se emplea para cargar recursos de imagen o vector.

Solicitud de la clave secreta compartida

Para solicitar una clave secreta compartida , envíe al equipo de asistencia técnica de Scene7 un mensaje de correo electrónico a la dirección s7support@adobe.com .
En el mensaje, proporcione el nombre de empresa que desee utilizar para cargar los recursos de imagen. Después de recibir la clave de Dynamic Media Classic, guárdela de forma local para usarla en el futuro.

Recuperación del distintivo de carga

El distintivo de carga garantiza que nadie más use la misma clave secreta compartida para cargar recursos. Garantiza que la carga sea legítima y que proceda de una fuente de confianza.
El distintivo de carga es una cadena alfanumérica que solo se encuentra disponible durante un tiempo concreto. Use las siguientes URL (sustituyendo la clave secreta compartida por la suya) para recuperar el distintivo de carga.
  • Imagen https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602 En este ejemplo, la clave secreta compartida es fece4b21-87ee-47fc-9b99-2e29b78b602
  • Vector https://s7ugc1.scene7.com/ugc/vector?op=get_uploadtoken&shared_secret=2d19f60e-890a-4e79-a1a5-9ac2875429b9 En este ejemplo, la clave secreta compartida es 2d19f60e-890a-4e79-a1a5-9ac2875429b9
De manera predeterminada, el distintivo de carga caduca en 5 minutos (300 segundos) después de recuperarlo. Si desea solicitar más tiempo, incluya en la URL expires seguido de la cantidad de tiempo necesaria en segundos. Por ejemplo, esta URL de imagen de ejemplo recupera un distintivo de carga válido durante 1.800 segundos:
https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&expires=1800

Éste es un ejemplo de respuesta correcta para imágenes:
<?xml version="1.0" encoding="UTF-8" standalone="no" ?> 
<scene7> 
    <user_generated_content> 
        <response> 
        <serviceName>User Generated Content - Images</serviceName> 
        <version>1.0.0</version> 
        <operationName>get_uploadtoken</operationName> 
        <serviceStatus>SUCCESS</serviceStatus> 
        <title>Upload Token for fece4b21-87ee-47fc-9b99-2e29b78b602</title> 
        <message> 
            <uploadtoken>aa2a378a-cd25-4c80-994d-312094e0ef20_1800</uploadtoken> 
            <expiration_in_seconds>1800</expiration_in_seconds> 
        </message> 
        </response> 
    </user_generated_content> 
</scene7>

Guarde el distintivo de carga en el equipo local para utilizarlo en las futuras solicitudes.
Se pueden usar los campos siguientes en la cadena de consulta URL para recuperar un distintivo de carga:
Parámetro de URL
Obligatorio u opcional
Valor
op
Obligatorio
get_uploadtoken
shared_secret
Obligatorio
Clave secreta compartida de la empresa que realiza la carga.
expires
Opcional
Número de segundos durante los que es válido el distintivo de carga. Si no se especifica, el valor predeterminado es 300 segundos.
URL de imagen de muestra:
https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&expires=600
URL de vector de prueba:
https://s7ugc1.scene7.com/ugc/vector?op=get_uploadtoken&shared_secret=2d19f60e-890a-4e79-a1a5-9ac2875429b9&expires=5000
Métodos HTTP permitidos: GET y POST
Ya puede cargar un recurso de imagen.

Carga de recursos de imagen

Después de recuperar un distintivo de carga válido durante un tiempo determinado, ya se puede cargar un recurso de imagen. El recurso se carga como una publicación de varias partes o formularios mientras que el resto de los valores se envía en forma de cadena de consulta URL, tal como se muestra en este ejemplo:
https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company

The upload_token and company_name fields are required.
También se pueden enviar otros valores opcionales en forma de cadenas de consulta URL, como en este ejemplo:
https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company&file_limit=2000000&file_exts=jpg,gif

The file_limit parameter specifies the file-size limit in bytes. El parámetro file_exts especifica las extensiones de nombre de archivo permitidas en la carga. Ambos valores son opcionales.
En la aplicación se definen límites globales tanto para el límite de tamaño de los archivos como para las extensiones de nombre de archivo permitidas. Todo lo incluido en la solicitud se acepta si es un subconjunto de los límites globales. Éstos son los límites globales:
Límite global
Valor
Tamaño de archivo para todos los clientes
20 MB
Formatos de archivo de imagen admitidos para la carga
BMP, GIF, JPG, PNG y PSD
El siguiente formulario HTML permite al usuario cargar un recurso. En el formulario se pide al usuario que introduzca la información siguiente:
  • Nombre de empresa.
  • Distintivo de carga.
  • Límite de tamaño de archivo.
  • Lista de extensiones de nombre de archivo.
  • Indica si se debe conservar o no el perfil de color y el nombre de archivo asociados al recurso.
  • Indica si se utiliza o no el fondo de cobertura. Si activa Fondo de cobertura, defina la esquina, la tolerancia y el método de relleno. Consulte Fondo de cobertura en las opciones de edición de imágenes durante la carga .
  • Nombre del archivo que se debe cargar
()
Puede vista del código fuente HTML asociado con el formulario anterior haciendo clic en el siguiente vínculo:
En Firefox, haga clic con el botón secundario en la ventana del explorador y, a continuación, haga clic en Vista de origen de página. El código muestra la cadena de consulta URL y el método POST oportunos que se ejecutan cuando el usuario hace clic en Enviar .
Para ver la respuesta en XML en Internet Explorer, haga clic en Ver > Código fuente . To view XML response in Firefox, click Tools > Web Developer > Page Source . Se recomienda utilizar Firefox para ver las respuestas en XML.
A continuación se muestra una respuesta de carga correcta de ejemplo:
<?xml version="1.0" encoding="UTF-8" standalone="no" ?> 
<scene7> 
    <user_generated_content> 
        <response> 
            <serviceName>User Generated Content - Images</serviceName> 
            <version>1.0.0</version> 
            <operationName>upload</operationName> 
            <serviceStatus>SUCCESS</serviceStatus> 
            <title>Your file has been uploaded Successfully.</title> 
            <message> 
            <url>https://s7w2p1.scene7.com/is/image/ </url> 
            <path>000Company/ugc/1442564.tif</path> 
            <fullurl>https://s7w2p1.scene7.com/is/image/000Company/ugc/1442564.tif </fullurl> 
            </message> 
        </response> 
    </user_generated_content> 
</scene7>

El recurso cargado (JPG, GIF, etc.) se convierte al formato PTIFF y la respuesta envía un vínculo directo a ese recurso PTIFF.
El recurso es igual que cualquier otro recurso de servicio de imágenes, es decir, se le pueden aplicar consultas de procesamiento. Por ejemplo, la URL siguiente solicita un recurso ajustado con la anchura y la altura especificadas.
https://s7w2p1.scene7.com/is/image/S7WebUGC/ugc/9536356.tif?&wid=800&hei=100&fit=stretch

Envíe el recurso para la carga como una publicación de varias partes o formularios y el resto de los valores en forma de cadena de consulta URL. Se pueden usar los campos siguientes en la cadena de consulta URL para cargar un recurso:
Parámetro de URL
Obligatorio u opcional
Valor
op
Obligatorio
cargar
upload_token
Obligatorio
Distintivo de carga para la clave secreta compartida asociada a la empresa.
company_name
Obligatorio
Nombre de la empresa que realiza la carga.
file_limit
Opcional
Límite de tamaño de archivo, en bytes, del recurso.
file_exts
Opcional
Lista de extensiones admitidas para el archivo de recurso de imagen.
preserve_colorprofile
Opcional
Conserva el perfil de color incrustado al convertir el archivo cargado a formato PTIFF. Los valores posibles son true y false. El valor predeterminado es false.
preserve_filename
Opcional
Conserva el nombre de archivo del recurso cargado. Los valores posibles son true y false. El valor predeterminado es false.
Es obligatorio enviar el recurso que se desea cargar como el único campo en las solicitudes POST de varias partes.
URL de ejemplo:
https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company
Método HTTP permitido:
POST

Obtención de los metadatos de los recursos de imagen

Se puede usar image_info para recuperar los metadatos de cualquier recurso cargado, tal como se muestra en el siguiente ejemplo:
https://s7ugc1.scene7.com/ugc/image?op=image_info&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&image_name=1442564.tif

Éste es un ejemplo de respuesta correcta:
<?xml version="1.0" encoding="UTF-8" standalone="no" ?> 
<scene7> 
    <user_generated_content> 
        <response> 
            <serviceName>User Generated Content - Images</serviceName> 
            <version>1.0.0</version> 
            <operationName>image_info</operationName> 
            <serviceStatus>SUCCESS</serviceStatus> 
            <title>More information on 1442564.tif</title> 
            <message> 
            File created on Tue Sep 08 19:02:04 CDT 2009, File Size = 243494 bytes 
            <imageFormat>Tiff</imageFormat> 
            <colorSpace>Rgb</colorSpace> 
            <width>686</width> 
            <height>457</height> 
            </message> 
        </response> 
    </user_generated_content> 
</scene7>

Se pueden usar los campos siguientes en la cadena de consulta URL para solicitar información de un recurso:
Parámetro de URL
Obligatorio u opcional
Valor
op
Obligatorio
image_info
shared_secret
Obligatorio
Clave secreta compartida de la empresa.
image_name
Obligatorio
Nombre de la imagen.
URL de ejemplo:
https://s7ugc1.scene7.com/ugc/image?op=image_info&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&image_name=1442564.tif
Método HTTP permitido:
GET y POST

Carga de recursos de vector

Después de recuperar un distintivo de carga válido durante un tiempo determinado, ya se puede cargar un recurso de vector. El recurso se carga como una publicación de varias partes o formularios mientras que el resto de los valores se envía en forma de cadena de consulta URL, tal como se muestra en este ejemplo:
https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d- 312094e0ef20_18000&company_name=000Company

The upload_token and company_name fields are required.
También se pueden enviar otros valores opcionales en forma de cadenas de consulta URL, como en este ejemplo:
https://s7ugc1.scene7.com/ugc/vector?op=upload&upload_token=aa2a378a-cd25-4c80-994d- 312094e0ef20_18000&company_name=000Company&file_limit=2000000&file_exts=ai,pdf

The file_limit parameter specifies the file-size limit in bytes. El parámetro file_exts especifica las extensiones de nombre de archivo permitidas en la carga. Ambos valores son opcionales.
En la aplicación se definen límites globales tanto para el límite de tamaño de los archivos como para las extensiones de nombre de archivo permitidas. Todo lo incluido en la solicitud se acepta si es un subconjunto de los límites globales. Éstos son los límites globales:
Límite global
Valor
Tamaño de archivo para todos los clientes
20 MB
Formatos de archivo de vector admitidos para la carga
AI, EPS, PDF (solo cuando el archivo PDF se haya abierto y guardado en Adobe Illustrator CS6)
El siguiente formulario HTML permite al usuario cargar un recurso. En el formulario se pide al usuario que introduzca la información siguiente:
  • Nombre de empresa.
  • Distintivo de carga.
  • Límite de tamaño de archivo.
  • Lista de extensiones de nombre de archivo.
  • Indica si se debe conservar o no el perfil de color y el nombre de archivo asociados al recurso.
  • Indica si se utiliza o no el fondo de cobertura. Si activa Fondo de cobertura, defina la esquina, la tolerancia y el método de relleno. Consulte Fondo de cobertura en las opciones de edición de imágenes durante la carga .
  • Nombre del archivo que se debe cargar
()
Al hacer clic con el botón derecho en la ventana del explorador y, luego, hacer clic en Ver código fuente , aparece el siguiente código, que corresponde al formulario mostrado en la ilustración. El código muestra la cadena de consulta URL y el método POST oportunos que se ejecutan cuando el usuario hace clic en Enviar .
<body> 
<script language="javascript"> 
function uploadImage() 
{ 
document.image_upload.action="vector?op=upload&company_name="+document.image_upload.company_name.value+"&upload_token="+document.image_upload.upload_token.value+"&file_limit="+document.image_upload.file_limit.value+"&file_exts="+document.image_upload.file_exts.value; 
return true; 
} 
</script> 
<form method="POST" enctype="multipart/form-data" name="image_upload" id="image_upload" onSubmit="return uploadImage();"> 
<table> 
<tr><td colspan="2"><strong> UGC Vector Upload Test Page: </strong></td></tr> 
<tr><td colspan="2"></td></tr> 
<tr><td><strong> Company Name</strong></td><td><input type="text" size="40" name="company_name"></td></tr> 
<tr><td><strong> Upload Token </strong></td><td><input type="text" size="40" name="upload_token"></td></tr> 
<tr><td><strong> File Size Limit (in bytes) </strong></td><td><input type="text" size="40" name="file_limit"> bytes</td></tr> 
<tr><td><strong> File Extensions allowed </strong></td><td><input type="text" size="40" name="file_exts"></td></tr> 
<tr><td colspan="2"></td></tr> 
<tr> 
<td><strong>File to upload: : </strong></td> 
<td><input name="filename" type="file" id="filename" size="58" maxlength="1024" /></td> 
</tr> 
<tr><td colspan="2"></td></tr> 
<tr> 
<td><strong>Click Submit to upload your Vector: </strong></td> 
<td><input type="submit" value="Submit"></td> 
</tr> 
</table> 
</form> 
</body>

Para ver la respuesta en XML en Internet Explorer, haga clic en Ver > Código fuente . Para ver la respuesta en XML en Firefox, haga clic en Ver > Código fuente de la página . Se recomienda utilizar Firefox para ver las respuestas en XML.
A continuación se muestra una respuesta de carga correcta de ejemplo:
<?xml version="1.0" encoding="UTF-8" standalone="no" ?> 
    <scene7> 
    <user_generated_content> 
    <response> 
    <serviceName>User Generated Content -Vector</serviceName> 
    <version>1.0.0</version> 
    <operationName>upload</operationName> 
    <serviceStatus>SUCCESS</serviceStatus> 
    <title>Your file has been uploaded Successfully.</title> 
    <message> 
    <url>https://s7w2p1.scene7.com/is/agm</url> 
    <path>W2PTest/ugc/8875744.fxg</path> 
    <fullurl> 
        https://s7w2p1.scene7.com/is/agm/W2PTest/ugc/8875744.fxg 
    </fullurl> 
</message> 
</response> 
</user_generated_content> 
</scene7>

El recurso cargado (AI, EPS, PDF, etc.) se convierte al formato FXG y la respuesta envía un vínculo directo a ese recurso FXG.
El recurso es igual que cualquier otro recurso de impresión virtual, es decir, se le pueden aplicar consultas de procesamiento. Por ejemplo, la siguiente URL convierte un recurso FXG en una imagen PNG de 500 x 500.
https://s7w2p1.scene7.com/is/agm/W2PTest/ugc/8875744.fxg?fmt=png&wid=500&hei=500

Envíe el recurso para la carga como una publicación de varias partes o formularios y el resto de los valores en forma de cadena de consulta URL. Se pueden usar los campos siguientes en la cadena de consulta URL para cargar un recurso:
Parámetro de URL
Obligatorio u opcional
Valor
op
Obligatorio
cargar
upload_token
Obligatorio
Distintivo de carga para la clave secreta compartida asociada a la empresa.
company_name
Obligatorio
Nombre de la empresa que realiza la carga.
file_limit
Opcional
Límite de tamaño de archivo, en bytes, del recurso.
file_exts
Opcional
Lista de extensiones admitidas para el archivo de recurso.
Es obligatorio enviar el recurso que se desea cargar como el único campo en las solicitudes POST de varias partes.
URL de ejemplo:
https://s7ugc1.scene7.com/ugc/vector?op=upload&upload_to ken=aa2a378a-cd25-4c80-994d- 312094e0ef20_18000&company_name=000Company
Método HTTP permitido:
POST