Saltar al contenido

Conector API

Resumen

El conector API tiene una conexión preconfigurada que proporciona acceso a las actividades de la API. Estas actividades, una vez configuradas, interactúan con APIs personalizadas configurado en Harmony API Manager.

Este conector tiene una conexión preconfigurada y no requiere configuración de conexión como es habitual en la mayoría de los conectores Harmony.

Importante

De forma predeterminada, las operaciones API exitosas (configuradas para APIs personalizadas o Servicios OData) no están incluidos en los registros de operación a menos que una de estas configuraciones esté habilitada:

  • Agentes en Nube: Para operaciones de API en un Agente en Nube, registro de depurar de operación debe estar habilitado en la operación.
  • Agentes Privados: Para operaciones API en un Agente Privado, ya sea registro de depurar de operación debe estar habilitado en la operación o debe configurar EnableLogging=true en el [APIOperation] sección del archivo de configuración del Agente Privado.

  • Se accede al conector API desde la pestaña Conectores y extremos del proyecto de la paleta de componentes de diseño (consulte Paleta de Componentes de Diseño).

    Descripción General del Conector

    Este conector está diseñado para usarse junto con una API Personalizada de API Manager para exponer una operación o un conjunto de operaciones como un extremo REST consumible.

    Los tipos de actividad se utilizan para crear instancias de actividades que están destinadas a usarse como fuentes (proporcionando datos) o destinos (recibiendo datos) en una operación.

    En conjunto, la conexión API preconfigurada y sus actividades se denominan extremo API:

    Tipos de actividad API

    • Pedido: Configurada mediante un esquema JSON, XML, CSV o XSD, esta actividad recupera datos cuando la llama una API Personalizada de API Manager y está destinado a ser utilizado como fuente para proporcionar datos a una operación.

    • Respuesta: Configurada mediante un esquema JSON, XML, CSV o XSD, esta actividad devuelve datos a una API Personalizada de API Manager y está destinado a ser utilizado como destino para consumir datos en una operación.

    • Solicitud SOAP: Configurada mediante un esquema WSDL, esta actividad recupera datos cuando la llama una API Personalizada de API Manager y está destinado a ser utilizado como fuente para proporcionar datos a una operación.

    • Respuesta SOAP: Configurada mediante un esquema WSDL, esta actividad devuelve datos a una API Personalizada de API Manager y está destinado a ser utilizado como destino para consumir datos en una operación.

    Nota

    Este conector es un conector nativo de Cloud Studio, al que Jitterbit puede hacer referencia cuando comunica cambios realizados en los conectores. El calendario de lanzamiento para conectores nativos de Cloud Studio se basa en la cadencia de las aplicaciones en la nube de Harmony.

    Variables de Jitterbit API

    Estas variables de Jitterbit se proporcionan específicamente para su uso con extremos de API:

    Solución de Problemas

    Si tiene problemas con el conector API, se recomiendan estos pasos de solución de problemas:

    1. Asegúrese de que la conexión API se realiza correctamente utilizando el botón Probar en la pantalla de configuración. Si la conexión no se realiza correctamente, el error devuelto puede proporcionar una indicación del problema.

    2. Verifique los registros de operación para cualquier información escrita durante la ejecución de la operación.

    3. Habilite el registro de depurar de operación (para Agentes en Nube o para Agentes Privados) para generar archivos de registro y datos adicionales.

    4. Si utiliza Agentes Privados, puede consultar los registros de agentes para más información.

    Referencia

    Para obtener información sobre la relación entre las actividades del conector API y las APIs de API Manager, consulte estos recursos: