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 APIs valt over het algemeen in twee brede categorieën: Lood Gegevensbestand, en Activa. Looddatabase-API's maken het mogelijk om persoonlijke records en bijbehorende objecttypen van Marketo op te halen en met elkaar te communiceren, zoals Opportunity en Companies. 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 false, en een serie van fouten in het "fouten"lid bevatten. Meer op 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 de instantie en ga naar Admin -> Users and Roles .

Klik op het tabblad Roles en vervolgens op Nieuwe rol en 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 .

Ga nu terug naar de tab 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 optie API Only en wijs de gebruiker de API-rol toe die u hebt gemaakt en klik op Next .

Klik op Send om het maken van de gebruiker te voltooien.

Ga vervolgens naar het menu Admin en klik op LaunchPoint .

Klik op het menu New en selecteer New Service . Geef uw service een beschrijvende naam en selecteer Custom in het vervolgkeuzemenu Service . Geef deze een beschrijving, selecteer vervolgens de nieuwe gebruiker in het vervolgkeuzemenu API Only User en klik op Create .

Klik op View Details voor uw nieuwe service om de client-id en het clientgeheim te openen. U kunt nu op de knop Get Token klikken om een toegangstoken te genereren dat een uur geldig is. Sla het token voorlopig op in een notitie.

Ga vervolgens naar het menu Admin en vervolgens naar Web Services .

Zoek de Endpoint in het vak REST API en sla deze op in een notitie voor nu.

Wanneer het maken van vraag aan REST API methodes, moet een toegangstoken in elke vraag worden omvat om de vraag succesvol te zijn. Het toegangstoken moet als kopbal van HTTP worden verzonden.

Authorization: Bearer cdf01657-110d-4155-99a7-f986b2ff13a0:int

Open een nieuw browser lusje en ga het volgende in, gebruikend de aangewezen informatie om te roepen krijgt Leads door het Type van Filter

<Your Endpoint URL>/rest/v1/leads.json?&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 klik op het aantal aanroepen in de afgelopen zeven dagen.