Fazer upload de um ativo de imagem rasterizada uploading-an-image-asset-or-a-vector-asset
Antes de carregar um ativo de imagem, primeiro solicite uma chave de segredo compartilhado. Você usa essa chave de segredo compartilhado para recuperar um token de upload. Em seguida, use o token de upload para fazer upload de ativos de imagem rasterizada.
Solicitar uma chave de segredo compartilhado requesting-a-shared-secret-key
Solicitar um chave de segredo compartilhado por usar o Admin Console para criar um caso de suporte. No caso de suporte, solicite uma chave de segredo compartilhado.
Na mensagem de email, forneça o nome da empresa que você deseja usar para fazer upload de ativos de imagem. Depois de receber a chave do Adobe Dynamic Media Classic, salve-a localmente para uso futuro.
Recuperar o token de upload retrieving-the-upload-token
A variável fazer upload do token A garante que ninguém possa usar a mesma chave de segredo compartilhado para carregar ativos. Ele garante que o upload seja legítimo e venha de uma fonte confiável.
O token de upload é uma sequência alfanumérica que está disponível somente por um período específico. Use os URLs a seguir, substituindo sua chave de segredo compartilhado, para que você possa recuperar o token de upload.
- Imagem raster
https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602
Neste exemplo, a chave de segredo compartilhado éfece4b21-87ee-47fc-9b99-2e29b78b602
Por padrão, o token de upload expira cinco minutos (300 segundos) após a recuperação. Para solicitar mais tempo, inclua expires
no URL e o tempo necessário em segundos. Por exemplo, o seguinte URL de imagem de amostra recupera um token de upload válido por 1800 segundos:
https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&expires=1800
A resposta bem-sucedida para imagens é semelhante ao seguinte:
<?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>
Salve o token de upload localmente para uso com solicitações futuras.
Você pode usar os seguintes campos na cadeia de caracteres do URL de consulta para recuperar um token de upload:
Amostra da URL da imagem rasterizada:
https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&expires=600
Métodos HTTP permitidos:GET
e POST
Agora você pode fazer upload de um ativo de imagem.
Consulte Fazer upload de um ativo de imagem.
Fazer upload de um ativo de imagem rasterizada uploading-an-image-asset
Depois de recuperar um token de upload válido por um período específico, você pode fazer upload de um ativo de imagem. Você faz upload do ativo como uma publicação multipart/form enquanto envia o restante dos valores como uma cadeia de caracteres de consulta de URL, conforme mostrado neste exemplo:
https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company
A variável upload_token
e company_name
campos são obrigatórios.
Consulte Recuperar o token de upload.
Consulte Recuperar uma chave de segredo compartilhado.
Você também pode enviar outros valores opcionais como cadeias de caracteres de consulta de URL, como neste exemplo:
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
A variável file_limit
O parâmetro especifica o limite do tamanho do arquivo em bytes. A variável file_exts
parameter especifica as extensões de nome de arquivo permitidas para upload. Ambos os valores são opcionais.
Um limite global é definido no aplicativo para o limite de tamanho do arquivo e as extensões de nome do arquivo permitidas. Se o que você enviou na solicitação for um subconjunto dos limites globais, ele será atendido. Os limites globais são os seguintes:
O formulário HTML a seguir permite que um usuário carregue um ativo. O formulário solicita que o usuário insira as seguintes informações:
- Um nome de empresa.
- Um token de upload.
- Um limite de tamanho de arquivo.
- Uma lista de extensões de nome de arquivo.
- Se o perfil de cores e o nome do arquivo associados ao ativo devem ser preservados.
- Usar plano de fundo de separação. Se você ativar Plano de fundo de separação, defina o Canto, a Tolerância e o Método de preenchimento.
Consulte Plano de fundo de separação em Opções de ajuste de imagem no upload. - O nome do arquivo a ser carregado.
Você pode exibir o código-fonte do HTML associado ao formulário acima selecionando https://s7ugc1.scene7.com/ugc/upload.html
No Firefox, clique com o botão direito do mouse na janela do navegador e selecione View Page Source. O código mostra a string de consulta de URL correspondente e o método POST executado quando o usuário seleciona Submit.
Para exibir a resposta XML no Internet Explorer, vá para View > Source. Para exibir a resposta XML no Firefox, acesse Tools > Browser Tools > Web Developer Tools. O Firefox é recomendado para exibir respostas XML.
Este é um exemplo de resposta de um upload bem-sucedido:
<?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>
O ativo é como qualquer outro recurso ImageServing; você pode aplicar consultas de processamento a ele. Por exemplo, o URL a seguir solicita um ativo que é ampliado até a largura e a altura especificadas.
https://s7w2p1.scene7.com/is/image/S7WebUGC/ugc/9536356.tif?&wid=800&hei=100&fit=stretch
Envie o ativo para fazer upload como uma publicação multipart/form enquanto envia o restante dos valores como uma cadeia de caracteres de consulta de URL. Você pode usar os seguintes campos na sequência de consulta do URL para fazer upload de um ativo:
op
upload_token
company_name
file_limit
file_exts
preserve_colorprofile
preserve_filename
Amostra do URL:
https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company
Método HTTP permitido:
POST
Obter metadados de ativos para imagens getting-asset-metadata-for-images
Você pode usar image_info
para recuperar metadados de um ativo carregado, conforme mostrado no exemplo a seguir:
https://s7ugc1.scene7.com/ugc/image?op=image_info&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&image_name=1442564.tif
Um exemplo de resposta bem-sucedida é semelhante ao seguinte:
<?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>
Você pode usar os seguintes campos na cadeia de caracteres de consulta do URL para solicitar informações de um ativo:
op
shared_secret
image_name
Amostra do URL:
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 e POST