Der API-Tracking-Identifikator

Alle Versionen der Autotask PSA Web Services API (SOAP und REST) erfordern Folgendes:

  • Die Verwendung eines Tracking-Identifikators. Alle Aufrufe mit Ausnahme von getZoneInfo() erfordern eine Tracking-ID. Dadurch können wir den Support und die Sicherheit für die API verbessern. Wir können individuell bestimmte Integrationen und Anbieter deaktivieren, die Probleme verursachen, ohne dass dies Auswirkungen auf den API-Zugriff aller anderen Benutzer hat.
  • Ein API-Benutzer (nur API) Zugriffsrecht und Lizenztyp (SOAP 1.6+ und REST).
  • Auf SOAP Version 1.5 und früher ist der Zugriff mit anderen Zugriffsrechten weiterhin möglich, sofern die Einstellung „Kann sich bei Web Services-API anmelden (Zugriff auf Version 1.6 & höher ist auf Zugriffsrechte für API-Benutzer beschränkt)“ für das Zugriffsrecht aktiviert ist.

Wenn Sie auf der Seite Integrationscenter eine Anbieterintegration auswählen, sind diese Integrationen mit Tracking-IDs verbunden, die Datto an die Anbieter vergeben hat, und sie funktionieren in allen Datenbanken. Die ID wird lediglich vom Anbieter verwendet und mit allen API-Aufrufen übergeben. Wenn es sich also um eine globale Integration von Drittanbietern handelt, wählen Sie einen Anbieter aus der Dropdown-Liste aus, und der Tracking-Identifikator wird automatisch in jeden API-Aufruf gesetzt.

Wenn Sie ein API-Benutzerkonto für eine benutzerdefinierte Integration einrichten, generiert Autotask PSA einen Tracking-Identifikator und zeigt ihn auf der Seite an. Sie müssen diesen Identifikator in den SOAP-Header kopieren.

So können Sie ...

Wenn Sie ein API-Benutzerkonto erstellen, müssen Sie den Abschnitt API-Tracking-Identifikator ausfüllen. Siehe API-Tracking-Identifikator.

Die Tracking-ID wird dann in den SOAP-Header kopiert. Hier ist ein SOAP XML-Beispiel, das auf den Tracking-Identifikator in den IntegrationCode-Tags verweist:

<?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>

WICHTIG  Sobald der Tracking-Identifikator generiert und gespeichert wurde, ist er schreibgeschützt und kann weder gelöscht noch bearbeitet werden.

HINWEIS  Sie müssen außerdem den Tag <AutotaskIntegrations > wie dargestellt beinhalten. Die Integration funktioniert nicht korrekt, wenn dies ausgelassen wird.