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.

  • Quota giornaliera: agli abbonamenti vengono assegnate 50.000 chiamate API al giorno (che vengono ripristinate ogni giorno alle 00.00 CST). Puoi aumentare la tua quota giornaliera tramite il tuo account manager.
  • Limite di frequenza: accesso API per istanza limitato a 100 chiamate per 20 secondi.
  • Limite concorrenza:  Massimo dieci chiamate API simultanee.

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 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.

Utenti e ruoli amministratori

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.

Nuovo ruolo

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.

Informazioni nuovo utente

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

Autorizzazioni per nuovi utenti

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

Nuovo messaggio utente

Passare quindi al menu Admin e fare clic su LaunchPoint.

Punto di avvio

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.

Nuovo servizio Launchpoint

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.

Ottieni token

Passare quindi al menu Admin, quindi a Web Services.

Servizi Web

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

Endpoint REST

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?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. Per visualizzare il tuo utilizzo, vai a Admin -> Integration > Web Services e fai clic sul numero di chiamate negli ultimi sette giorni.

recommendation-more-help
bb269a6d-047a-4bf7-9acd-23ad9a63dc59