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 generalmente rientrano in due categorie generali: Database lead, e Risorsa. 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 durante la chiamata, in genere l’API restituisce il codice di stato 200, ma la risposta JSON conterrà un membro "success" con il valore falsee un array di errori nel membro "errors". Ulteriori informazioni sugli errori qui.

Guida introduttiva

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

Per la prima chiamata a Marketo, recupererai 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.

Fai clic su Roles , quindi Nuovo ruolo e assegnare almeno l'autorizzazione "Read-Only Lead" (o "Read-Only Person") al ruolo nel gruppo Access API. Assegna un nome descrittivo e fai clic su Create.

Ora torniamo al Users e fai clic su Invite New User. Assegna all’utente un nome descrittivo che indica che si tratta di un utente API, un Indirizzo e-mail e fai clic su Next.

Quindi, seleziona la API Only e assegna all’utente il ruolo API creato e fai clic su Next.

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

Quindi, vai al Admin e fai clic su LaunchPoint.

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

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

Quindi, vai al  Admin menu, quindi a Web Services.

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

Apri una nuova scheda del browser e immetti quanto segue, utilizzando le informazioni appropriate per chiamare Ottieni lead per tipo di filtro:

<Your Endpoint URL>/rest/v1/leads.json?access_token=<Your Access Token>&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. Scopri come utilizzi andando in Admin -> Integration > Web Services e facendo clic sul numero di chiamate negli ultimi sette giorni.