Cargar un recurso de imagen de trama uploading-an-image-asset-or-a-vector-asset
Para poder cargar un recurso de imagen, primero debe solicitar una clave secreta compartida. Esta clave permite recuperar un distintivo de carga. A continuación, utilice el token de carga para cargar recursos de imagen rasterizada.
Solicitar una clave de secreto compartido requesting-a-shared-secret-key
Solicite una clave de secreto compartido shared-secret de usando el Admin Console para crear un caso de asistencia. En el caso de soporte técnico, solicite una clave de secreto compartido.
En el mensaje, proporcione el nombre de empresa que desee utilizar para cargar los recursos de imagen. Una vez que reciba la clave de Adobe Dynamic Media Classic, guárdela localmente para usarla en el futuro.
Recuperación del token de carga retrieving-the-upload-token
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. Utilice las siguientes direcciones URL, sustituyendo la clave de secreto compartido, para poder recuperar el token de carga.
- Imagen rasterizada
https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602
En este ejemplo, la clave de secreto compartido esfece4b21-87ee-47fc-9b99-2e29b78b602
De manera predeterminada, el distintivo de carga caduca en 5 minutos (300 segundos) después de recuperarlo. Para solicitar más tiempo, incluya expires
en la dirección URL y el tiempo que necesite 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
La respuesta correcta para las imágenes aparece de forma similar a la siguiente:
<?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:
URL de imagen de trama de muestra:
https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&expires=600
Métodos HTTP permitidos:GET
y POST
Ya puede cargar un recurso de imagen.
Consulte Cargar un recurso de imagen.
Cargar un recurso de imagen de trama uploading-an-image-asset
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
Los campos upload_token
y company_name
son obligatorios.
Consulte Recuperar el token de carga.
Consulte Recuperar una clave de secreto compartido.
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
El parámetro file_limit
especifica el límite de tamaño de archivo en bytes. El parámetro file_exts
especifica las extensiones de nombre de archivo que se permiten para 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. Si lo que ha enviado en la solicitud es un subconjunto de los límites globales, se cumple. Éstos son los límites globales:
El siguiente formulario HTML permite al usuario cargar un recurso. En el formulario se pide al usuario que introduzca la información siguiente:
- Un nombre de empresa.
- Un token de carga.
- Un límite de tamaño de archivo.
- Una lista de extensiones de nombre de archivo.
- Si se conserva el perfil de color y el nombre de archivo asociados al recurso.
- Si se debe utilizar un fondo de cobertura. Si activa Fondo de cobertura (Knockout Background), defina las opciones Esquina (Corner), Tolerancia (Tolerance) y Relleno (Fill Method).
Consulte Fondo de cobertura en Opciones de ajuste de imagen al cargar. - Nombre del archivo que se va a cargar.
Puede ver el código fuente del HTML asociado con el formulario anterior seleccionando https://s7ugc1.scene7.com/ugc/upload.html
En Firefox, haga clic con el botón derecho en la ventana del explorador y seleccione Ver página Source. El código muestra la cadena de consulta de URL correspondiente y el método de POST que se ejecuta cuando el usuario selecciona Enviar.
Para ver la respuesta XML en Internet Explorer, ve a Ver > Source. Para ver la respuesta XML en Firefox, ve a Herramientas > Herramientas de navegador > Herramientas para desarrolladores web. 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 es igual que cualquier otro recurso de servicio de imágenes, es decir, se le pueden aplicar consultas de procesamiento. Por ejemplo, la siguiente URL solicita un recurso que se expande a la anchura y 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:
op
upload_token
company_name
file_limit
file_exts
preserve_colorprofile
preserve_filename
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
Obtener metadatos de recursos para imágenes getting-asset-metadata-for-images
Puede usar image_info
para recuperar metadatos de un recurso que haya cargado, 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
Aparece un ejemplo de respuesta correcta similar al siguiente:
<?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:
op
shared_secret
image_name
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