Acerca de los servicios web about-web-services

Definición de las API de Adobe Campaign definition-of-adobe-campaign-apis

El servidor de aplicaciones de Adobe Campaign se ha diseñado para que sea abierto y fácil de integrar con sistemas de información de la empresa cada vez más diversos y complejos.

Las API de Adobe Campaign se utilizan en JavaScript SOAP dentro de la aplicación y en la fuera de ella. Constituyen una biblioteca de funciones genéricas que se pueden enriquecer. SOAP Para obtener más información, consulte Implementación de métodos de.

IMPORTANT
La cantidad de llamadas al motor autorizadas por día varía según el contrato de licencia. Para obtener más información, consulte esta página.
Hay disponible una lista de todas las API, con su descripción completa, en [esta documentación dedicada] (https://experienceleague.adobe.com/developer/campaign-api/api/index.html?lang=es.

Requisitos previos prerequisites

Antes de usar las API de Adobe Campaign, debe estar familiarizado con los siguientes temas:

  • Javascript
  • SOAP protocolo de
  • Modelo de datos Adobe Campaign

Uso de API de Adobe Campaign using-adobe-campaign-apis

Adobe Campaign utiliza dos tipos de API:

  • API genéricas de acceso a datos para consultar los datos del modelo de datos. Consulte API orientadas a datos.
  • API específicas para empresas que le permiten actuar sobre cada objeto: envíos, flujos de trabajo, suscripciones, etc. Consulte API orientadas a la empresa.

Para desarrollar API e interactuar con Adobe Campaign, debe estar familiarizado con el modelo de datos. Adobe Campaign permite generar una descripción completa de la base. Consulte Descripción del modelo.

Llamadas SOAP soap-calls

SOAP El protocolo de le permite invocar métodos de API a través del cliente enriquecido, aplicaciones de terceros que utilizan servicios web o JSP que utilizan estos métodos de forma nativa.

SOAP La estructura de un mensaje de es la siguiente:

  • un sobre que define la estructura del mensaje,
  • un encabezado opcional,
  • un cuerpo que contiene la información sobre la llamada y la respuesta,
  • administración de errores que define la condición de error.

Recursos e intercambios resources-and-exchanges

El esquema siguiente muestra los distintos recursos implicados en el uso de las API de Adobe Campaign:

SOAP Ejemplo de un mensaje de en el método "ExecuteQuery" example-of-a-soap-message-on-the--executequery--method--

SOAP En este ejemplo, una consulta de invoca el método "ExecuteQuery", que toma una cadena de caracteres como parámetro para la autenticación (token de sesión) y un contenido XML para la descripción de la consulta que se va a ejecutar.

Para obtener más información, consulte ExecuteQuery (xtk:queryDef).

NOTE
La descripción WSDL de este servicio se completa en el ejemplo que se muestra aquí: Descripción del servicio web: WSDL.

SOAP consulta de soap-query

<?xml version='1.0' encoding='ISO-8859-1'?>
  <SOAP-ENV:Envelope xmlns:xsd='http://www.w3.org/2001/XMLSchema' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xmlns:ns='http://xml.apache.org/xml-soap' xmlns:SOAP-ENV='http://schemas.xmlsoap.org/soap/envelope/'>
    <SOAP-ENV:Body>
      <ExecuteQuery xmlns='urn:xtk:queryDef' SOAP-ENV:encodingStyle='http://schemas.xmlsoap.org/soap/encoding/'>
        <__sessiontoken xsi:type='xsd:string'/>
        <entity xsi:type='ns:Element' SOAP-ENV:encodingStyle='http://xml.apache.org/xml-soap/literalxml'>
          <queryDef firstRows="true" lineCount="200" operation="select" schema="nms:rcpGrpRel" startLine="0" startPath="/" xtkschema="xtk:queryDef">
          ...
          </queryDef>
        </entity>
      </ExecuteQuery>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

SOAP El elemento <soap-env:envelope> es el primer elemento del mensaje que representa el sobre de la.

El elemento <soap-env:body> es el primer elemento secundario del sobre. Contiene la descripción del mensaje, es decir, el contenido de la consulta o la respuesta.

SOAP El método que se va a invocar se especifica en el elemento <executequery> desde el cuerpo del mensaje de la.

SOAP En la práctica, los parámetros se reconocen por orden de aparición. El primer parámetro, <__sessiontoken>, toma la cadena de autenticación; el segundo parámetro es la descripción XML de la consulta del elemento <querydef>.

SOAP respuesta de la soap-response

<?xml version='1.0' encoding='ISO-8859-1'?>
  <SOAP-ENV:Envelope xmlns:xsd='http://www.w3.org/2001/XMLSchema' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xmlns:ns='http://xml.apache.org/xml-soap' xmlns:SOAP-ENV='http://schemas.xmlsoap.org/soap/envelope/'>
    <SOAP-ENV:Body>
      <ExecuteQueryResponse xmlns='urn:xtk:queryDef' SOAP-ENV:encodingStyle='http://schemas.xmlsoap.org/soap/encoding/'>
        <pdomOutput xsi:type='ns:Element' SOAP-ENV:encodingStyle='http://xml.apache.org/xml-soap/literalxml'>
          <rcpGrpRel-collection><rcpGrpRel group-id="1872" recipient-id="1362"></rcpGrpRel></rcpGrpRel-collection>
        </pdomOutput>
      </ExecuteQueryResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

El resultado de la consulta se especifica desde el elemento <pdomoutput>.

Administración de errores error-management

SOAP Ejemplo de respuesta de error:

<?xml version='1.0' encoding='ISO-8859-1'?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV='http://schemas.xmlsoap.org/soap/envelope/'>
  <SOAP-ENV:Body>
    <SOAP-ENV:Fault>
      <faultcode>SOAP-ENV:Server</faultcode>
      <faultstring>Error while executing 'Write' of the 'xtk:persist'.</faultstring> service
      <detail>ODBC error: [Microsoft][ODBC SQL Server Driver][SQL Server]Cannot insert duplicate key row in object 'XtkOption' with unique index 'XtkOption_name'. SQLSTate: 23000
ODBC error: [Microsoft][ODBC SQL Server Driver][SQL Server]The statement has been terminated. SQLSTate: 01000 Cannot save the 'Options (xtk:option)' document </detail>
    </SOAP-ENV:Fault>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

SOAP El elemento <soap-env:fault> del cuerpo del mensaje de la se utiliza para transmitir las señales de error que surgen durante el procesamiento del servicio web. Se compone de los siguientes subelementos:

  • <faultcode> : indica el tipo de error. Los tipos de error son:

    • SOAP "VersionMismatch" en caso de incompatibilidad con la versión de la versión de la versión utilizada,
    • "MustUnderstand" en caso de problemas en el encabezado del mensaje,
    • "Cliente" en el caso de que al cliente le falte información,
    • "Server" en el caso de que el servidor tenga un problema al ejecutar el procesamiento.
  • <faultstring> : mensaje que describe el error

  • <detail> : mensaje de error largo

El éxito o error de la invocación del servicio se identifica cuando se verifica el elemento <faultcode>.

IMPORTANT
Todos los servicios web de Adobe Campaign administran errores. Por lo tanto, se recomienda probar cada llamada para controlar los errores devueltos.

Ejemplo de control de errores en C#:

try
{
  // Invocation of method
  ...
}
catch (SoapException e)
{
  System.Console.WriteLine("Soap exception: " + e.Message);
  if (e.Detail != null)
    System.Console.WriteLine(e.Detail.InnerText);
}

URL del servidor del servicio web (o EndPoint) url-of-web-service-server--or-endpoint-

Para enviar el servicio web, se debe contactar con el servidor de Adobe Campaign que implementa el método de servicio correspondiente.

La URL del servidor es la siguiente:

https://serverName/nl/jsp/soaprouter.jsp

Con <server>, el servidor de aplicaciones de Adobe Campaign (nlserver web).

recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1