REST API

Ultimo aggiornamento: 19 dicembre 2024
  • Argomenti:

Creato per:

  • Amministratore

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.

NOTE
L’API dell’SOAP è diventata obsoleta e non sarà più disponibile dopo il 31 ottobre 2025. Tutti i nuovi sviluppi devono essere eseguiti con Marketo REST API e i servizi esistenti devono essere migrati entro tale data per evitare interruzioni del servizio. Se si dispone di un servizio che utilizza l'API SOAP, consultare la Guida alla migrazione dell'API SOAP per informazioni su come eseguire la migrazione.
  • 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: l'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 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.

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

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
IMPORTANT
Il supporto per l'autenticazione tramite il parametro di query access_token verrà rimosso il 30 giugno 2025. Se il progetto utilizza un parametro di query per passare il token di accesso, deve essere aggiornato per utilizzare l'intestazione Authorization il prima possibile. Il nuovo sviluppo deve utilizzare esclusivamente l'intestazione Authorization.

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
}