REST API

Marketo espone un’API REST che consente l’esecuzione remota di molte delle funzionalità del sistema. Dalla creazione di programmi all’importazione in blocco di lead, sono disponibili molte opzioni che consentono il controllo dettagliato di un’istanza di Marketo.

Queste API in genere rientrano in due categorie generali: Lead Database e Asset. Le API del database lead consentono il recupero e l’interazione con i record persona di Marketo e i tipi di oggetto associati, ad esempio Opportunità e Società. Le API Asset consentono l’interazione con materiale promozionale di marketing e record relativi al flusso di lavoro.

La dimensione delle chiamate standard è limitata a una lunghezza URI di 8 KB e a una dimensione corpo di 1 MB, anche se il corpo può essere di 10 MB per le nostre API in blocco. Se si verifica un errore in con la chiamata, in genere l'API restituisce il codice di stato 200, ma la risposta JSON conterrà un membro "success" con un valore di false e una matrice di errori nel membro "errors". Ulteriori informazioni sugli errori qui.

Guida introduttuva

I passaggi seguenti richiedono i privilegi di amministratore nell’istanza Marketo.

Per la prima chiamata a Marketo, recupera un record di lead. Per iniziare a utilizzare Marketo, devi ottenere le credenziali API per effettuare chiamate autenticate all’istanza. Accedi all'istanza e passa a Admin -> Users and Roles.

Fare clic sulla scheda Roles, quindi su Nuovo ruolo e assegnare almeno l'autorizzazione "Lead di sola lettura" (o "Persona di sola lettura") al ruolo nel gruppo API di accesso. Assicurarsi di assegnare un nome descrittivo e fare clic su Create.

Tornare alla scheda Users e fare clic su Invite New User. Assegnare all'utente un nome descrittivo che indichi che si tratta di un utente API, un indirizzo di posta elettronica e fare clic su Next.

Quindi, seleziona l'opzione API Only e assegna all'utente il ruolo API creato, quindi fai clic su Next.

Per completare il processo di creazione utente, fare clic su Send.

Passare quindi al menu Admin e fare clic su LaunchPoint.

Fare clic sul menu New e selezionare New Service. Assegna un nome descrittivo al servizio e seleziona Custom dal menu a discesa Service. Fornisci una descrizione, quindi seleziona il nuovo utente dal menu a discesa API Only User e fai clic su Create.

Fare clic su View Details per il nuovo servizio per accedere all'ID client e al segreto client. Per il momento puoi fare clic sul pulsante Get Token per generare un token di accesso valido per un'ora. Per il momento salva il token in una nota.

Passare quindi al menu Admin, quindi a Web Services.

Trova Endpoint nella casella API REST e salva per il momento in una nota.

Quando si effettuano chiamate ai metodi API REST, per garantire la riuscita della chiamata è necessario includere un token di accesso in ogni chiamata. Il token di accesso deve essere inviato come intestazione HTTP.

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

Apri una nuova scheda del browser e immetti quanto segue, utilizzando le informazioni appropriate per chiamare Get Leads by Filter Type

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

Se nel database non è presente un record di lead con l'indirizzo di posta elettronica, sostituirlo con uno che si sa essere presente. Premi Invio nella barra URL e dovresti ricevere una risposta JSON simile alla seguente:

{
    "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
}

Utilizzo API

Ciascuno degli utenti API viene segnalato singolarmente nel rapporto sull’utilizzo delle API, pertanto la suddivisione dei servizi web per utente consente di tenere facilmente conto dell’utilizzo di ciascuna integrazione. Se il numero di chiamate API all’istanza supera il limite e le chiamate successive non riescono, l’utilizzo di questa procedura ti consente di tenere conto del volume di ciascuno dei servizi e di valutare come risolvere il problema. Per visualizzare il tuo utilizzo, vai a Admin -> Integration > Web Services e fai clic sul numero di chiamate negli ultimi sette giorni.