REST API

L’API REST di Marketo fornisce l’accesso remoto a molte funzionalità di sistema. Puoi utilizzarlo per creare programmi, importare lead in blocco e controllare un’istanza di Marketo a un livello dettagliato.

Le API REST rientrano in due categorie generali:

Le chiamate API standard hanno una lunghezza massima dell’URI di 8 KB e una dimensione massima del corpo di 1 MB. Le chiamate API in blocco supportano una dimensione massima del corpo di 10 MB.

Quando una chiamata contiene un errore, in genere l’API restituisce ancora il codice di stato HTTP 200. La risposta JSON contiene un membro success con un valore di false e un array di errori nel membro errors. Ulteriori informazioni sugli errori sono disponibili qui.

Guida introduttuva

Per completare la procedura seguente, è necessario disporre dei privilegi di amministratore nell’istanza Marketo. Questo flusso di lavoro crea le credenziali API e le utilizza per recuperare un record lead.

Innanzitutto, crea un utente API e ottieni le credenziali per le chiamate autenticate. Accedi all’istanza e passa a Admin > Users and Roles.

Selezionare la scheda Roles, quindi selezionare Nuovo ruolo. Assegna al ruolo almeno l’autorizzazione “Lead di sola lettura” (o “Persona di sola lettura”) dal gruppo API di accesso. Assegna un nome descrittivo al ruolo e seleziona Create.

Torna alla scheda Users e seleziona Invite New User. Immettere un nome descrittivo che identifichi l’utente come utente API, immettere un indirizzo e-mail e selezionare Next.

Selezionare l’opzione API Only, assegnare il ruolo API creato e selezionare Next.

Selezionare Send per creare l’utente.

Quindi, passare al menu Admin e selezionare LaunchPoint.

Selezionare New > New Service. Immettere un nome e una descrizione descrittivi e selezionare Custom dal menu Service. Selezionare il nuovo utente dal menu API Only User, quindi selezionare Create.

Selezionare View Details per il nuovo servizio per accedere all’ID client e al segreto client. Selezionare Get Token per generare un token di accesso valido per un’ora. Salva il token per la prima chiamata API.

Vai a Admin > Web Services.

Trova Endpoint nella casella REST API e salvalo per la prima chiamata API.

Ogni chiamata API REST deve includere un token di accesso in un’intestazione HTTP.

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

Apri una nuova scheda del browser e immetti il seguente URL. Sostituisci i segnaposto con l’endpoint e l’indirizzo e-mail dell’istanza per chiamare Get Leads by Filter Type.

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

Se il database non contiene un record di lead con il tuo indirizzo e-mail, utilizza l’indirizzo e-mail di un lead esistente. Invia l’URL per ricevere una risposta JSON simile al seguente esempio:

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

Il rapporto sull’utilizzo delle API tiene traccia di ogni utente API separatamente. L’assegnazione di un utente separato a ciascun servizio web consente di identificare l’utilizzo API di ogni integrazione.

Se le chiamate superano il limite di istanza e le chiamate successive non riescono, utilizza il rapporto per identificare il volume di chiamate da ciascun servizio. Vai a Admin > Integration > Web Services e seleziona il numero di chiamate effettuate negli ultimi sette giorni.

Per gli endpoint REST che restituiscono le statistiche di utilizzo e di errore giornaliere e degli ultimi 7 giorni, vedere Utilizzo.