Webservices

Laatst bijgewerkt: 18 september 2024
  • Onderwerpen:
  • API

Gemaakt voor:

  • Ontwikkelaar

Definitie van Adobe Campaign API's

De Adobe Campaign-toepassingsserver is ontworpen voor openheid en eenvoudige integratie met steeds meer uiteenlopende en complexe bedrijfsinformatiesystemen.

Adobe Campaign API's worden gebruikt in JavaScript binnen de toepassing en in SOAP daarbuiten. Ze vormen een bibliotheek van generieke functies die kunnen worden verrijkt. Voor verdere informatie, verwijs naar het Uitvoeren SOAP methodes.

IMPORTANT
Het aantal geoorloofde Vraag van de Motor varieert per dag op uw vergunningscontract. Raadpleeg deze pagina voor meer informatie.
Een lijst van alle APIs met inbegrip van hun volledige beschrijving is beschikbaar in [ deze specifieke documentatie ] (https://experienceleague.adobe.com/developer/campaign-api/api/index.html?lang=nl-NL.

Vereisten

Voordat u de Adobe Campaign API's kunt gebruiken, moet u vertrouwd zijn met de volgende onderwerpen:

  • Javascript
  • SOAP
  • Adobe Campaign-gegevensmodel

Adobe Campaign API's gebruiken

Adobe Campaign gebruikt twee typen API's:

  • Algemene API's voor gegevenstoegang voor het opvragen van gegevens van het gegevensmodel. Verwijs naar Gegevens georiënteerde APIs.
  • Bedrijfsspecifieke API's waarmee u op elk object kunt reageren: leveringen, workflows, abonnementen, enzovoort. Verwijs naar Bedrijfs georiënteerde APIs.

Om APIs te ontwikkelen en met Adobe Campaign in wisselwerking te staan, moet u met uw gegevensmodel vertrouwd zijn. Met Adobe Campaign kunt u een volledige beschrijving van de basis genereren. Verwijs naar Beschrijving van het model.

SOAP

Het SOAP protocol laat u API methodes, via de rijke cliënt, derdetoepassingen aanhalen gebruikend webservices, of JSP gebruikend deze methodes.

De structuur van een SOAP is als volgt:

  • een omhulsel dat de structuur van het bericht aangeeft;
  • een optionele koptekst,
  • een instantie die de informatie over de oproep en de reactie bevat;
  • foutbeheer dat de foutvoorwaarde definieert.

Middelen en uitwisselingen

In het volgende schema ziet u de verschillende bronnen die betrokken zijn bij het gebruik van Adobe Campaign API's:

Voorbeeld van een SOAP bericht over de methode 'ExecuteQuery'

In dit voorbeeld roept een SOAP query de methode "ExecuteQuery" aan, die een tekenreeks neemt als een parameter voor verificatie (sessietoken) en een XML-inhoud voor de beschrijving van de query die moet worden uitgevoerd.

Voor verdere informatie, verwijs naar ExecuteQuery (xtk:queryDef).

NOTE
De beschrijving van WSDL van deze dienst wordt voltooid in het hier getoonde voorbeeld: de dienstbeschrijving van het Web: WSDL.

SOAP 

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

Het element <soap-env:envelope> is het eerste element van het bericht dat de SOAP omhulsel vertegenwoordigt.

Het element <soap-env:body> is het eerste onderliggende element van de omhulling. Het bevat de beschrijving van het bericht, d.w.z. de inhoud van de vraag of de reactie.

De methode die moet worden aangeroepen, wordt in het element <executequery> ingevoerd vanuit de hoofdtekst van het SOAP.

SOAP worden de parameters op volgorde van weergave herkend. De eerste parameter, <__sessiontoken> , neemt de verificatieketen, de tweede parameter is de XML-beschrijving van de query van het <querydef> -element.