El identificador de seguimiento de la API
Todas las versiones de la API de Servicios Web de Autotask (SOAP y REST) requieren lo siguiente:
- El uso de un identificador de seguimiento. Todas las llamadas a excepción de getZoneInfo () requieren un Id. de seguimiento. Esto les permitirá mejorar el soporte y la seguridad de la API. Podemos deshabilitar individualmente integraciones y proveedores específicos que estén causando problemas sin impactar el acceso a la API para nadie más.
- Un nivel de seguridad y tipo de licencia Usuario de API (Solamente de API) (SOAP 1.6+ y REST).
- Otros niveles de seguridad aún pueden acceder a SOAP versión 1.5 y anteriores, siempre y cuando la configuración Puede iniciar sesión en la API de Servicios Web (El acceso a la versión 1.6 y posteriores está limitado a los niveles de seguridad de Usuario de API). esté habilitada por su nivel de seguridad.
Si selecciona una integración de proveedor en la página del Centro de Integración, esas integraciones están asociadas con IDs de seguimiento que Datto ha emitido a los proveedores, y funcionarán en todas las instancias de Autotask. Solamente el proveedor tiene el Id. y lo transfiere con todas las llamadas de API. Así, si se trata de una integración global de terceros, se selecciona un proveedor en el menú desplegable y el identificador de seguimiento se pone automáticamente en cada llamada a la API.
Si está configurando una cuenta de usuario de la API para una integración personalizada, Autotask generará un identificador de seguimiento y lo mostrará en la página. Debe copiar este identificador en el encabezado SOAP.
Cómo...
Al crear una cuenta de usuario de API, debe completar la sección Identificador de seguimiento de la API. Consulte Identificador de seguimiento de API.
El Id. de seguimiento luego se copia en el encabezado SOAP. A continuación se presenta un ejemplo XML de SOAP que hace referencia al identificador de seguimiento dentro de las etiquetas IntegrationCode:
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Header>
<AutotaskIntegrations >
<IntegrationCode>[substitute tracking identifier here]</IntegrationCode>
</AutotaskIntegrations>
</soap:Header>
<soap:Body>
<query >
<sXML><![CDATA[<queryxml><entity>Account</entity><query><condition><field>id<expression op="greaterthan">0</expression></field></condition></query></queryxml>]]></sXML>
</query>
</soap:Body>
</soap:Envelope>
IMPORTANTE Una vez que se genera y guarda el identificador de seguimiento, se vuelve de solo lectura y no puede ni eliminarse ni editarse.
NOTA Usted debe también incluir <AutotaskIntegrations> como se muestra. La integración no funcionará adecuadamente si esta se omite.