REST API

Marketo maakt een REST API beschikbaar waarmee een groot aantal mogelijkheden van het systeem op afstand kan worden uitgevoerd. Er zijn veel opties, variërend van het maken van programma's tot het bulksgewijs importeren van leads, waarmee u een Marketo-instantie met fijnkorrelige besturing kunt besturen.

Deze API's vallen over het algemeen in twee brede categorieën: Database lead, en Element. Looddatabase-API's maken het mogelijk om persoonlijke records en bijbehorende objecttypen, zoals Opportunity en Companies, op te halen en te communiceren met Marketo. API's voor bedrijfsmiddelen maken interactie met marketingmateriaal en workflowgerelateerde gegevens mogelijk.

De grootte van standaardvraag is beperkt tot een lengte van URI van 8KB, en een lichaamsomvang van 1MB, hoewel het lichaam 10MB voor onze bulk APIs kan zijn. Als er een fout in uw vraag is, zal API typisch nog een statuscode van 200 terugkeren, maar de reactie JSON zal een "succes"lid met een waarde van bevatten falseen een array met fouten in het lid 'fouten'. Meer informatie over fouten hier.

Aan de slag

De volgende stappen vereisen beheerdersrechten in uw Marketo-instantie.

Voor uw eerste oproep aan Marketo haalt u een lead record op. Als u met Marketo wilt gaan werken, moet u API-referenties opvragen om geverifieerde aanroepen naar uw instantie te kunnen uitvoeren. Meld u aan bij uw exemplaar en ga naar de Admin -> Users and Roles.

Klik op de knop Roles en vervolgens Nieuwe rol. Wijs ten minste de machtiging Alleen-lezen regel (of Alleen-lezen persoon) toe aan de rol in de API-groep Toegang. Geef deze een beschrijvende naam en klik op Create.

Nu terug naar de Users en klik op Invite New User. Geef uw gebruiker een beschrijvende naam die aangeeft dat het een API-gebruiker is, en een e-mailadres en klik op Next.

Controleer vervolgens de API Only en geef uw gebruiker de API-rol die u hebt gemaakt en klik op Next.

Als u het maken van de gebruiker wilt voltooien, klikt u op Send.

Ga vervolgens naar de Admin menu en klik op LaunchPoint.

Klik op de knop New en selecteert u New Service. Geef uw service een beschrijvende naam en selecteer Custom van de Service vervolgkeuzelijst. Geef het een beschrijving, dan selecteer uw nieuwe gebruiker van API Only User vervolgkeuzemenu en klik op Create.

Klikken View Details voor uw nieuwe dienst om tot identiteitskaart van de Cliënt en Geheim van de Cliënt toegang te hebben. U kunt nu op de knop Get Token om een toegangstoken te produceren die één uur geldig is. Sla het token voorlopig op in een notitie.

Ga vervolgens naar de  Admin menu, dan naar Web Services.

Zoek de Endpoint in het vak REST API en in een notitie opslaan voor nu.

Open een nieuw browser lusje en ga het volgende in, gebruikend de aangewezen informatie om te roepen Regels ophalen op filtertype:

<Your Endpoint URL>/rest/v1/leads.json?access_token=<Your Access Token>&filterType=email&filterValues=<Your Email Address>

Als u geen hoofdrecord hebt met uw e-mailadres in uw database, vervangt u dit door een adres waarvan u weet dat het aanwezig is. Druk op Enter in de URL-balk en u krijgt een JSON-reactie die hierop lijkt:

{
    "requestId":"c493#1511ca2b184",
    "result":[
       {
           "id":1,
           "updatedAt":"2015-08-24T20:17:23Z",
           "lastName":"Elkington",
           "email":"developerfeedback@marketo.com",
           "createdAt":"2013-02-19T23:17:04Z",
           "firstName":"Kenneth"
        }
    ],
    "success":true
}

API-gebruik

Elk van uw API-gebruikers wordt afzonderlijk vermeld in het API-gebruiksrapport, dus als u uw webservices opgesplitst naar gebruiker, kunt u gemakkelijk rekenschap geven van het gebruik van elk van uw integratie. Als het aantal API vraag aan uw instantie de grens overschrijdt en verdere vraag veroorzaakt om te ontbreken, staat het gebruiken van deze praktijk u toe om voor het volume van elk van uw diensten rekenschap te geven en laat u evalueren hoe te om de kwestie op te lossen. Ga naar Admin -> Integration > Web Services en het klikken van het aantal vraag in de afgelopen zeven dagen.