REST API

Marketo visar ett REST API som tillåter fjärrexekvering av många av systemets funktioner. Det finns många alternativ, från att skapa program till att importera leads, som ger detaljerad kontroll av en Marketo-instans.

Dessa API:er kan i allmänhet delas in i två kategorier: Leaddatabas och resurs. Med API:er för lead-databaser kan du hämta och interagera med Marketo-personposter och associerade objekttyper som säljprojekt och företag. Tillgångs-API:er möjliggör interaktion med marknadsföringsmaterial och arbetsflödesrelaterade poster.

Storleken på standardanrop är begränsad till en URI-längd på 8 kB och en kroppsstorlek på 1 MB, även om brödtexten kan vara 10 MB för våra större API:er. Om det finns ett fel i ditt anrop returnerar API vanligtvis fortfarande statuskoden 200, men JSON-svaret innehåller en "success"-medlem med värdet false och en matris med fel i "errors"-medlemmen. Mer information om fel här.

Komma igång

Följande steg kräver administratörsbehörighet i din Marketo-instans.

När du ringer till Marketo får du en leadpost. Om du vill börja arbeta med Marketo måste du ha API-autentiseringsuppgifter för att kunna göra autentiserade anrop till din instans. Logga in på din instans och gå till Admin -> Users and Roles.

Klicka på fliken Roles och sedan på Ny roll och tilldela rollen i API-gruppen minst behörigheten Skrivskyddad lead (eller Skrivskyddad person). Ge den ett beskrivande namn och klicka på Create.

Gå tillbaka till fliken Users och klicka på Invite New User. Ge användaren ett beskrivande namn som anger att det är en API-användare och en e-postadress och klicka på Next.

Kontrollera sedan alternativet API Only och tilldela användaren den API-roll som du skapade och klicka på Next.

Klicka på Send om du vill slutföra användarskapandeprocessen.

Gå sedan till menyn Admin och klicka på LaunchPoint.

Klicka på menyn New och välj New Service. Ge tjänsten ett beskrivande namn och välj Custom i listrutan Service. Ge den en beskrivning, välj sedan din nya användare i listrutan API Only User och klicka på Create.

Klicka på View Details om du vill att den nya tjänsten ska få åtkomst till klient-ID och klienthemlighet. För tillfället kan du klicka på knappen Get Token för att generera en åtkomsttoken som är giltig i en timme. Spara variabeln i en anteckning tills vidare.

Gå sedan till menyn Admin och till Web Services.

Leta reda på Endpoint i rutan REST API och spara i en anteckning för tillfället.

Öppna en ny flik i webbläsaren och ange följande, med lämplig information för att anropa Hämta leads efter filtertyp:

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

Om du inte har någon lead-post med din e-postadress i databasen kan du ersätta den med en som du vet finns där. Tryck på Retur i URL-fältet så får du tillbaka ett JSON-svar som påminner om detta:

{
    "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-användning

Var och en av dina API-användare rapporteras separat i API-användningsrapporten, så om du delar upp dina webbtjänster efter användare kan du enkelt ta hänsyn till hur de olika integreringarna används. Om antalet API-anrop till din instans överstiger gränsen och leder till att efterföljande anrop misslyckas, kan du med den här metoden ta hänsyn till volymen från varje tjänst och låta dig utvärdera hur problemet kan lösas. Se din användning genom att gå till Admin -> Integration > Web Services och klicka på antalet samtal under de senaste sju dagarna.