Versões WSDL do Serviço Web IPS | Adobe Experience Manager
O IPS Web Service é suportado por um conjunto de documentos WSDL (Web Services Description Language) que são acessados a partir de qualquer instalação IPS em que o componente IPS Web Service está instalado. Cada versão da API do IPS inclui um novo arquivo WSDL que faz referência a um namespace XML de destino com versão. As versões anteriores do namespace WSDL também são compatíveis com versões anteriores dos aplicativos existentes.
Acesso WSDL
Acesse os WSDLs do Scene7 conforme mostrado abaixo.
O valor padrão para <IPS_webapp> é scene7.
O URL de serviço é especificado na seção de serviço do documento WSDL do Serviço Web IPS. O URL de serviço geralmente tem o formato :
URLs de acesso para regiões do Dynamic Media
URL de armazenamento temporário (uso para desenvolvimento e teste pré-produção)
Europa, Médio Oriente, Ásia
WSDLs compatíveis
Lembre-se de que talvez seja necessário modificar seu código para usar os recursos na versão mais recente da API do IPS. A API IPS suporta WSDLs para as seguintes versões:
Namespace da API
Pré-4.0
Os aplicativos existentes que precisam ser modificados para usar novos recursos devem atualizar para a versão mais recente da API e podem precisar fazer alterações no código existente. Consulte o log de alterações para obter detalhes.
O Serviço Web de API IPS suporta apenas uma associação SOAP.
Transportes compatíveis
O vínculo SOAP da API IPS é compatível somente com transporte HTTP. Faça todas as solicitações SOAP usando o método POST HTTPS.
Cabeçalho de ação SOAP
Para processar uma solicitação, defina o cabeçalho HTTP SOAPAction como o nome da operação solicitada. O atributo nome da operação na seção de vínculo WSDL especifica o nome.
O estilo document/literal é usado para todas as mensagens de entrada e saída com tipos com base na linguagem de definição do Esquema XML ( https://www.w3.org/TR/xmlschema-0/) e especificado no arquivo WSDL. Todos os tipos exigem nomes qualificados usando o valor de namespace de destino especificado no arquivo WSDL.
Autenticação da solicitação
O método preferido para transmitir credenciais de autenticação em solicitações de API é usar o elemento authHeader conforme definido no WSDL da API do IPS.
Email de usuário IPS válido.
Senha da conta de usuário.
Local opcional para solicitação. Consulte Localidade para obter detalhes.
Chamando o nome do aplicativo. Esse parâmetro é opcional, mas é recomendável incluí-lo em todas as solicitações.
Chamando a versão do aplicativo.
Sinalizador opcional para ativar ou desativar a compactação gzip do XML de resposta. Por padrão, as respostas são compactadas por gzip se o cabeçalho HTTP Accept-Encoding indicar suporte para gzip.
defaultHttpStatusCode
Parâmetro opcional para substituir o código de status HTTP para respostas de falha. Por padrão, as respostas de falha retornam o código de status HTTP 500 (Internal Server Error). Algumas plataformas clientes, incluindo o Flash Adobe, não podem ler o corpo da resposta a menos que um código de status 200 (OK) seja retornado.
O elemento authHeader é sempre definido no namespace http://www.scene7.com/IpsApi/xsd, independentemente da versão da API.
A seguir, um exemplo de uso do elemento authHeader em um cabeçalho SOAP de solicitação:
Outros métodos de autenticação de solicitação
Se, por algum motivo, seu aplicativo cliente não puder passar o cabeçalho SOAP authHeader, as solicitações de API também poderão especificar credenciais usando a autenticação HTTP Basic (conforme especificado em RFC 2617).
Para autenticação HTTP Basic, a seção cabeçalho HTTP de cada solicitação de POST SOAP deve incluir um cabeçalho do formulário:
Onde base64() aplica a codificação Base64 padrão, <IPS_user_email> é o endereço de email de um usuário IPS válido e <password> é a senha do usuário.
Envie o cabeçalho de Autorização antecipadamente com a solicitação inicial. Se nenhuma credencial de autenticação for incluída na solicitação, IpsApiService não responderá com um código de status 401 (Unauthorized). Em vez disso, um código de status 500 (Internal Server Error) é retornado com um corpo de falha SOAP declarando que a solicitação não pôde ser autenticada.
Antes do IPS 3.8, a autenticação por meio do cabeçalho SOAP era implementada usando os elementos AuthUser e AuthPassword no namespace http://www.scene7.com/IpsApi. Por exemplo:
Esse estilo ainda é compatível com compatibilidade anterior, mas foi substituído pelo elemento authHeader.
Depois que as credenciais do chamador forem autenticadas, a solicitação será verificada para garantir que o chamador esteja autorizado a executar a operação solicitada. A autorização é baseada na função de usuário do chamador e também pode exigir a verificação da empresa de destino, usuário de destino e outros parâmetros de operação. Além disso, os usuários do Portal de imagens devem pertencer a um Grupo com as permissões necessárias para executar determinadas operações de pasta e ativo. A seção de referência Operações descreve os requisitos de autorização para cada operação.
Exemplo de solicitação e resposta SOAP
O exemplo a seguir mostra uma operação addCompany completa, incluindo cabeçalhos HTTP:
E a resposta correspondente:
Falhas de SOAP
Quando uma operação encontra uma condição de exceção, uma falha SOAP é retornada como o corpo da mensagem SOAP no lugar da resposta normal. Por exemplo, se um usuário não administrador tentar enviar a solicitação addCompany anterior, a seguinte resposta será retornada: