Come collegare una fonte dati alla tua API
Ultimo aggiornamento
Con una fonte dati API collegata, Sendtric chiama la tua API per recuperare i dati di un iscritto quando la sua email viene aperta. Non viene copiato nulla su Sendtric, quindi le immagini mostrano esattamente ciò che la tua API restituisce in quel momento, come lo stato in tempo reale di un ordine o il saldo del conto di oggi.
Se preferisci inviare i dati a Sendtric in anticipo, dai un'occhiata a come inviare i record tramite l'API di Sendtric.
Cosa serve alla tua API
- Un URL HTTPS raggiungibile dalla rete Internet pubblica.
- Un modo per richiedere un record in base al suo identificatore, presente nel percorso o in un parametro di query. Ad esempio
https://api.example.com/customers/12345. - A risposta JSON con i campi del record, come ad esempio
{"first_name": "Sarah", "points": 1250}. - Una risposta veloce: Sendtric aspetta fino a 5 secondi e la risposta deve essere inferiore a 1 MB.
Configuralo
- Nella barra laterale a sinistra, clicca su Origini dati, poi Nuova fonte di dati.
- Sotto API, seleziona API e clicca su Continua.
- Scegli Recupera i dati da un'API e clicca su Continua.
- Compila Nome della fonte dati, Campo identificativo univoco (ad esempio
customer_id) e, se vuoi, Descrizione. - Scegli il Metodo: GET o POST.
- Inserisci l'URL della tua API e metti
{{uid}}l'identificatore al posto del "", ad esempiohttps://api.example.com/customers/{{uid}}. Sendtric sostituisce{{uid}}con l’identificatore di ciascun iscritto. - Aggiungi eventuali intestazioni di cui la tua API ha bisogno, come
Authorizationcon il tuo token API. Clicca su + Aggiungi per ciascuna di esse. - Aggiungi qualsiasi parametri di query. Se la tua API accetta l'identificatore come parametro, inseriscilo
{{uid}}il suo valore al posto dell'URL, ad esempioid={{uid}}. - Inserisci un identificatore valido nel Verifica valore identificatore univoco e clicca su Prova API.
- Controlla la risposta, poi clicca su Salva origine dati.

Salva fonte dati rimane disabilitata finché il test non va a buon fine e la risposta contiene almeno un campo. Se modifichi l'URL, il metodo, le intestazioni o i parametri, riprova il test.
Usa un endpoint di prova o un token API dedicato e di sola lettura. Sendtric mantiene segreti i valori dell'intestazione dopo il salvataggio, quindi dovrai inserirne uno nuovo per modificarlo.
Come funzionano le ricerche
- Ogni ricerca invia una richiesta alla tua API per un singolo abbonato.
- Gli identificatori vengono inviati esattamente come vengono inseriti dal tag di unione, quindi le maiuscole e le minuscole contano se la tua API ne tiene conto.
- Sendtric conserva un'immagine generata per il tempo di cache che hai impostato nell'editor di immagini (da 2 a 60 minuti), così le aperture ripetute non richiamano la tua API ogni volta.
- Se la tua API è lenta, restituisce un errore o non trova alcun record per l'identificatore, il valore viene considerato vuoto. In un'immagine personalizzata, quel livello viene nascosto, quindi progetta l'immagine in modo che risulti comunque corretta anche senza di esso.
Modifica la connessione
In Fonti dati, clicca sull'origine dati per aprirne le impostazioni. Puoi modificare l'URL, il metodo, le intestazioni e i parametri, quindi eseguire Test API di nuovo prima di salvare.
Prossimo passo
- Come usare una fonte di dati in un'immagine personalizzata
- Come usare una fonte di dati in un'immagine basata su regole
- Cosa sono le fonti di dati e come funzionano?
Questo articolo ti è stato utile?
Grazie per il tuo commento!
