Show Menu
TÓPICOS×

Fazer upload de um ativo de imagem ou de um ativo vetorial

Antes de poder carregar um ativo de imagem, solicite primeiro uma chave de segredo compartilhado. Use 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 ou ativos de vetor.

Solicitação de uma chave de segredo compartilhado

Solicite uma chave de segredo compartilhado enviando um email para o suporte técnico do Scene 7 em s7support@adobe.com .
Na mensagem de email, forneça o nome da empresa que deseja usar para fazer upload de ativos de imagem. Depois de receber a chave do Dynamic Media Classic, salve-a localmente para uso futuro.

Recuperando o token de upload

O token de upload garante que ninguém possa usar a mesma chave de segredo compartilhado para fazer upload de ativos. Ele garante que o upload seja legítimo e provém de uma fonte confiável.
O token de upload é uma sequência de caracteres alfanuméricos que está disponível somente por um período específico. Use os seguintes URLs, substituindo sua chave de segredo compartilhado, para recuperar o token de upload.
  • Imagem https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602 Neste exemplo, a chave shared-secret é fece4b21-87ee-47fc-9b99-2e29b78b602
  • Vetor https://s7ugc1.scene7.com/ugc/vector?op=get_uploadtoken&shared_secret=2d19f60e-890a-4e79-a1a5-9ac2875429b9 Neste exemplo, a chave shared-secret é 2d19f60e-890a-4e79-a1a5-9ac2875429b9
Por padrão, o token de upload expira cinco minutos (300 segundos) após sua recuperação. Para solicitar mais tempo, inclua expires o URL e o tempo necessário em segundos. Por exemplo, o URL de exemplo a seguir 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 usar com solicitações futuras.
Você pode usar os seguintes campos na string do URL de consulta para recuperar um token de upload:
Parâmetro de URL
Obrigatório ou opcional
Valor
op
Obrigatório
get_uploadtoken
shared_secret
Obrigatório
A chave de segredo compartilhado da empresa que está fazendo o upload.
expira
Opcional
Número de segundos em que o token de carregamento é válido. O padrão é 300 segundos, se não for especificado.
URL da imagem de amostra:
https://s7ugc1.scene7.com/ugc/image?op=get_uploadtoken&shared_secret=fece4b21-87ee-47fc-9b99-2e29b78b602&expires=600
URL de vetor de amostra:
https://s7ugc1.scene7.com/ugc/vector?op=get_uploadtoken&shared_secret=2d19f60e-890a-4e79-a1a5-9ac2875429b9&expires=5000
​Métodos HTTP permitidos: GET e POST
Agora é possível carregar um ativo de imagem.
Consulte Carregar um ativo de imagem.

Fazer upload de um ativo de imagem

Depois de recuperar um token de upload válido por um período específico, você pode carregar um ativo de imagem. Você carrega o ativo como uma publicação multipart/form ao enviar o restante dos valores como uma sequência de consulta de URL, como mostra este exemplo:
https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company

Os campos upload_token e company_name são obrigatórios.
Consulte Recuperar o token de upload.
Consulte Recuperando uma chave de segredo compartilhado.
Você também pode enviar outros valores opcionais como sequências 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

O file_limit parâmetro especifica o limite de tamanho de arquivo em bytes. O file_exts parâmetro 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 de arquivo e as extensões de nome de arquivo permitidas. Se o que você enviar na solicitação for um subconjunto dos limites globais, ele será respeitado. Os limites globais são os seguintes:
Limite global
Valor
Tamanho do arquivo para todos os clientes
20 MB
Formatos de arquivo de imagem suportados para upload
BMP, GIF, JPG, PNG, PSD
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 carregamento.
  • Um limite de tamanho de arquivo.
  • Uma lista de extensões de nome de arquivo.
  • A preservação ou não do perfil de cores e do nome de arquivo associados ao ativo.
  • Usar ou não o Plano de fundo de separação. Se você ativar o 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 nas opções de edição de imagens no upload .
  • O nome do arquivo a ser carregado
()
Você pode exibir o código-fonte HTML associado ao formulário acima clicando no link a seguir:
No Firefox, clique com o botão direito do mouse na janela do navegador e clique em Exibir fonte da página. O código mostra a string de consulta de URL correspondente e o método POST que são executados quando o usuário clica em Enviar .
Para exibir a resposta XML no Internet Explorer, clique em Exibir > Fonte . Para exibir a resposta XML no Firefox, clique em Ferramentas > Desenvolvedor da Web > Fonte da página. O Firefox é recomendado para exibir respostas XML.
A seguir está uma amostra 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 carregado (JPG, GIF e assim por diante) é convertido no formato PTIFF e a resposta envia um link direto para esse ativo PTIFF.
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 é esticado 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 multiparte/formulário ao enviar o restante dos valores como uma sequência de consulta de URL. Você pode usar os seguintes campos na sequência de consulta URL para carregar um ativo:
Parâmetro de URL
Obrigatório ou opcional
Valor
op
Obrigatório
upload
upload_token
Obrigatório
Carregue o token da chave de segredo compartilhado associada à empresa.
company_name
Obrigatório
Nome da empresa que está executando o upload.
file_limit
Opcional
Limite de tamanho de arquivo, em bytes, para o ativo.
file_exts
Opcional
Lista de extensões permitidas para o arquivo de ativo de imagem.
preserve_color_profile
Opcional
Preserva qualquer perfil de cor incorporado ao converter o arquivo carregado para o formato PTIFF. Valores possíveis são verdadeiros ou falsos. O padrão é falso.
preserve_filename
Opcional
Preserva o nome de arquivo do ativo carregado. Valores possíveis são verdadeiros ou falsos. O padrão é falso.
É necessário enviar o ativo para ser carregado como o único campo em uma solicitação POST multiparte.
URL de exemplo:
https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d-312094e0ef20_18000&company_name=000Company
Método HTTP permitido:
POSTAGEM

Obter metadados de ativos para imagens

Você pode usar image_info para recuperar metadados de um ativo que carregou, como 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 uma 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 sequência de consulta do URL para solicitar informações para um ativo:
Parâmetro de URL
Obrigatório ou opcional
Valor
op
Obrigatório
image_info
shared_secret
Obrigatório
A chave secreta compartilhada da empresa.
image_name
Obrigatório
Nome da imagem.
URL de exemplo:
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

Fazer upload de um ativo vetorial

Depois de recuperar um token de upload válido por um período específico, você pode fazer upload de um ativo de vetor. Você carrega o ativo como uma publicação multipart/form ao enviar o restante dos valores como uma sequência de consulta de URL, como mostra este exemplo:
https://s7ugc1.scene7.com/ugc/image?op=upload&upload_token=aa2a378a-cd25-4c80-994d- 312094e0ef20_18000&company_name=000Company

Os campos upload_token e company_name são obrigatórios.
Consulte Recuperar o token de upload.
Consulte Recuperando uma chave de segredo compartilhado.
Você também pode enviar outros valores opcionais como sequências de consulta de URL, como neste exemplo:
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

O file_limit parâmetro especifica o limite de tamanho de arquivo em bytes. O file_exts parâmetro 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 de arquivo e as extensões de nome de arquivo permitidas. Se o que você enviar na solicitação for um subconjunto dos limites globais, ele será respeitado. Os limites globais são os seguintes:
Limite global
Valor
Tamanho do arquivo para todos os clientes
20 MB
Formatos de arquivo vetorial suportados para upload
AI, EPS, PDF (somente quando o PDF foi aberto e salvo anteriormente no Adobe Illustrator CS6)
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 carregamento.
  • Um limite de tamanho de arquivo.
  • Uma lista de extensões de nome de arquivo.
  • A preservação ou não do perfil de cores e do nome de arquivo associados ao ativo.
  • Usar ou não o Plano de fundo de separação. Se você ativar o 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 nas opções de edição de imagens no upload .
  • O nome do arquivo a ser carregado
()
O seguinte código HTML é exibido quando você clica com o botão direito do mouse na janela do navegador e, em seguida, clica em Exibir fonte para o formulário mostrado na ilustração. O código mostra a string de consulta de URL correspondente e o método POST que são executados quando o usuário clica em 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 exibir a resposta XML no Internet Explorer, clique em Exibir > Fonte . Para exibir a resposta XML no Firefox, clique em Exibir > Fonte ​da página. O Firefox é recomendado para exibir respostas XML.
A seguir está uma amostra 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 -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>

O ativo carregado (AI, EPS, PDF etc.) é convertido no formato FXG e a resposta envia um link direto para esse ativo FXG.
O ativo é como qualquer outro recurso Web para impressão; você pode aplicar consultas de processamento a ele. Por exemplo, o URL a seguir converte um recurso FXG em uma imagem 500x500 png.
https://s7w2p1.scene7.com/is/agm/W2PTest/ugc/8875744.fxg?fmt=png&wid=500&hei=500

Envie o ativo para fazer upload como uma publicação multiparte/formulário ao enviar o restante dos valores como uma sequência de consulta de URL. Você pode usar os seguintes campos na sequência de consulta URL para carregar um ativo:
Parâmetro de URL
Obrigatório ou opcional
Valor
op
Obrigatório
upload
upload_token
Obrigatório
Carregue o token da chave de segredo compartilhado associada à empresa.
company_name
Obrigatório
Nome da empresa que está executando o upload.
file_limit
Opcional
Limite de tamanho de arquivo, em bytes, para o ativo.
file_exts
Opcional
Lista de extensões permitidas para o arquivo de ativos.
É necessário enviar o ativo para ser carregado como o único campo em uma solicitação POST multiparte.
URL de exemplo:
https://s7ugc1.scene7.com/ugc/vector?op=upload&upload_to ken=aa2a378a-cd25-4c80-994d- 312094e0ef20_18000&company_name=000Company
Método HTTP permitido:
POSTAGEM