--- title: Utilizzare l'API GraphQL di Yapla description: Scopri come usare l'API GraphQL di Yapla per interrogare e gestire i tuoi dati. Guida tecnica alla configurazione di query, mutazioni e integrazioni. --- [Passa al contenuto](https://support.yapla.com/it-it/utilizzare-lapi-graphql-di-yapla#main-content) - [Italiano - Italia](https://support.yapla.com/it-it/utilizzare-lapi-graphql-di-yapla) - [English - Canada](https://support.yapla.com/en-ca/using-the-yapla-graphql-api) - [Français - Canada](https://support.yapla.com/fr-ca/utiliser-lapi-graphql-de-yapla) - [Français - France](https://support.yapla.com/fr-fr/utiliser-lapi-graphql-de-yapla) Italiano - Italia Mostra sottomenu per le traduzioni [Ulteriore assistenza](https://support.yapla.com/it-it/kb-tickets/new?hsLang=it-it) [Portale clienti](https://support.yapla.com/tickets-view?hsLang=it-it) [![logo-centro-di-assistenza-yapla](https://support.yapla.com/hs-fs/hubfs/logo-centro-di-assistenza-yapla.png?width=880&height=119&name=logo-centro-di-assistenza-yapla.png)](https://support.yapla.com/it-it/?hsLang=it-it) - [Programma un incontro](https://www.yapla.com/it/incontro?utm_term=plateforme) - [Yapla Academy](https://formazione.yapla.com/) Apri navigazione principale Chiudi navigazione principale - [Programma un incontro](https://www.yapla.com/it/incontro?utm_term=plateforme) - [Yapla Academy](https://formazione.yapla.com/) - - [Italiano - Italia](https://support.yapla.com/it-it/utilizzare-lapi-graphql-di-yapla) - [English - Canada](https://support.yapla.com/en-ca/using-the-yapla-graphql-api) - [Français - Canada](https://support.yapla.com/fr-ca/utiliser-lapi-graphql-de-yapla) - [Français - France](https://support.yapla.com/fr-fr/utiliser-lapi-graphql-de-yapla) Italiano - Italia Mostra sottomenu per le traduzioni - [Ulteriore assistenza](https://support.yapla.com/it-it/kb-tickets/new) - [Portale clienti](https://support.yapla.com/tickets-view) - [Contattaci](https://support.yapla.com/it-it/kb-tickets/new) [Contattaci](https://support.yapla.com/it-it/kb-tickets/new?hsLang=it-it) In che modo possiamo aiutarti? - Non sono presenti suggerimenti perché il campo di ricerca è vuoto. 1. [Yapla Centro di assistenza](https://support.yapla.com/it-it?hsLang=it-it) 2. [Documentazione per gli sviluppatori](https://support.yapla.com/it-it/documentazione-per-gli-sviluppatori?hsLang=it-it) 3. [Funzioni avanzate](https://support.yapla.com/it-it/documentazione-per-gli-sviluppatori?hsLang=it-it#funzioni-avanzate) # Utilizzare l'API GraphQL di Yapla Yapla ti consente di ottenere e modificare dati sempre più vari grazie alla sua API GraphQL. ### Prerequisito: Autenticazione Per utilizzare l'API, è necessario ottenere prima un token di accesso (`access token`) tramite il protocollo OAuth2. [Questo articolo spiega la procedura per ottenerlo.](https://support.yapla.com/hc/it-it/articles/42528776206355?hsLang=it-it) Puoi quindi utilizzare l'**endpoint dell'API**, che varia in base alla tua regione: - America del Nord: `https://s1.yapla.com/graphql` - Europa: [`https://s2.yapla.com/graphql`](https://s2.yapla.com/graphql) ### Introspezione / Visualizzare i campi radice GraphQL è basato su schemi, il che consente di comprendere a colpo d'occhio tutte le funzionalità di un'API. Utilizzando la tua piattaforma di test API (ad esempio: [Postman](https://www.postman.com/), [HTTPie](https://httpie.io/), ecc.), esegui un'**introspezione** per esplorare lo schema del server e conoscere i campi radice disponibili.  ![Capture d’écran, le 2025-08-11 à 11.30.22](https://support.yapla.com/hs-fs/hubfs/Capture%20d%E2%80%99%C3%A9cran%2c%20le%202025-08-11%20%C3%A0%2011.30.22.png?width=366&height=277&name=Capture%20d%E2%80%99%C3%A9cran%2c%20le%202025-08-11%20%C3%A0%2011.30.22.png) Il server ti fornirà quindi l'elenco dei **campi radice** dai quali potrai recuperare o manipolare i dati. In GraphQL, questi sono i punti di ingresso dell'API. ![Capture d’écran, le 2025-08-11 à 11.30.36](https://support.yapla.com/hs-fs/hubfs/Capture%20d%E2%80%99%C3%A9cran%2c%20le%202025-08-11%20%C3%A0%2011.30.36.png?width=393&height=275&name=Capture%20d%E2%80%99%C3%A9cran%2c%20le%202025-08-11%20%C3%A0%2011.30.36.png)   ### Operazioni possibili Yapla mette a disposizione campi per due tipi di operazioni: - **Query** – Recupera dati dal server. Una *query* specifica le informazioni richieste per il campo indicato e può includere argomenti per precisare il recupero dei dati. - **Mutation** – Manipola i dati sul server (creazione, modifica, eliminazione). Una *mutation* specifica i dati da restituire dopo l'operazione e può anche includere argomenti per dettagliare l'operazione. Nota: In GraphQL, il server restituisce o modifica solo i dati richiesti nella query, evitando di recuperare troppe o troppo poche informazioni. Per ulteriori informazioni sul funzionamento di GraphQL, è possibile consultare [la documentazione relativa alle specifiche GraphQL](https://graphql.org/learn/). ### Campi pubblici e privati Tra i campi radice, non tutti hanno lo stesso livello di accesso: - **Campi pubblici**: accessibili senza autenticazione o autorizzazione specifica. Utilizzati per dati o operazioni che non comportano rischi per la sicurezza (es. visualizzazione di informazioni generali). - **Campi privati**: protetti da un meccanismo di autenticazione e/o autorizzazione. Utilizzati per manipolare o consultare dati sensibili o per eseguire azioni riservate a determinati ruoli.     - [Inizia con Yapla](https://support.yapla.com/it-it/inizia-con-yapla?hsLang=it-it#main-content) - [Raccolta di risorse utili per scoprire Yapla](https://support.yapla.com/it-it/inizia-con-yapla?hsLang=it-it#raccolta-di-risorse-utili-per-scoprire-yapla) - [Per iniziare](https://support.yapla.com/it-it/inizia-con-yapla?hsLang=it-it#per-iniziare) - [Ottimizzare l'utilizzo di Yapla](https://support.yapla.com/it-it/inizia-con-yapla?hsLang=it-it#ottimizzare-lutilizzo-di-yapla) - [Informazioni su Yapla](https://support.yapla.com/it-it/inizia-con-yapla?hsLang=it-it#informazioni-su-yapla) - [Configura il tuo account](https://support.yapla.com/it-it/configura-il-tuo-account?hsLang=it-it#main-content) - [Primi passi](https://support.yapla.com/it-it/configura-il-tuo-account?hsLang=it-it#primi-passi) - [Account](https://support.yapla.com/it-it/configura-il-tuo-account?hsLang=it-it#account) - [Fatturazione](https://support.yapla.com/it-it/configura-il-tuo-account?hsLang=it-it#fatturazione) - [Licenze e utenti](https://support.yapla.com/it-it/configura-il-tuo-account?hsLang=it-it#licenze-e-utenti) - [Domande frequenti](https://support.yapla.com/it-it/configura-il-tuo-account?hsLang=it-it#domande-frequenti) - [Capire le funzionalità comuni](https://support.yapla.com/it-it/capire-le-funzionalit%C3%A0-comuni?hsLang=it-it#main-content) - [Comunicazioni](https://support.yapla.com/it-it/capire-le-funzionalit%C3%A0-comuni?hsLang=it-it#comunicazioni) - [Moduli](https://support.yapla.com/it-it/capire-le-funzionalit%C3%A0-comuni?hsLang=it-it#moduli) - [Immagini e media](https://support.yapla.com/it-it/capire-le-funzionalit%C3%A0-comuni?hsLang=it-it#immagini-e-media) - [Domande frequenti](https://support.yapla.com/it-it/capire-le-funzionalit%C3%A0-comuni?hsLang=it-it#domande-frequenti) - [Gestire i tuoi pagamenti e la tua autenticazione](https://support.yapla.com/it-it/gestire-i-tuoi-pagamenti-e-la-tua-autenticazione?hsLang=it-it#main-content) - [Autenticazione](https://support.yapla.com/it-it/gestire-i-tuoi-pagamenti-e-la-tua-autenticazione?hsLang=it-it#autenticazione) - [Pagamento](https://support.yapla.com/it-it/gestire-i-tuoi-pagamenti-e-la-tua-autenticazione?hsLang=it-it#pagamento) - [Contributo volontario e commissione](https://support.yapla.com/it-it/gestire-i-tuoi-pagamenti-e-la-tua-autenticazione?hsLang=it-it#contributo-volontario-e-commissione) - [Domande frequenti](https://support.yapla.com/it-it/gestire-i-tuoi-pagamenti-e-la-tua-autenticazione?hsLang=it-it#domande-frequenti) - [Gestire i membri](https://support.yapla.com/it-it/gestire-i-membri?hsLang=it-it#main-content) - [Primi passi](https://support.yapla.com/it-it/gestire-i-membri?hsLang=it-it#primi-passi) - [Importare i membri](https://support.yapla.com/it-it/gestire-i-membri?hsLang=it-it#importare-i-membri) - [Campagne di adesione semplificate](https://support.yapla.com/it-it/gestire-i-membri?hsLang=it-it#campagne-di-adesione-semplificate) - [Gestione dei membri](https://support.yapla.com/it-it/gestire-i-membri?hsLang=it-it#gestione-dei-membri) - [Scheda del membro](https://support.yapla.com/it-it/gestire-i-membri?hsLang=it-it#scheda-del-membro) - [Modulo](https://support.yapla.com/it-it/gestire-i-membri?hsLang=it-it#modulo) - [Comunicazioni](https://support.yapla.com/it-it/gestire-i-membri?hsLang=it-it#comunicazioni) - [Gestione delle organizzazioni o famiglie](https://support.yapla.com/it-it/gestire-i-membri?hsLang=it-it#gestione-delle-organizzazioni-o-famiglie) - [Gestione delle adesioni](https://support.yapla.com/it-it/gestire-i-membri?hsLang=it-it#gestione-delle-adesioni) - [Prezzi](https://support.yapla.com/it-it/gestire-i-membri?hsLang=it-it#prezzi) - [Organizzazione o famiglia](https://support.yapla.com/it-it/gestire-i-membri?hsLang=it-it#organizzazione-o-famiglia) - [Funzioni avanzate](https://support.yapla.com/it-it/gestire-i-membri?hsLang=it-it#funzioni-avanzate) - [Formazione continua](https://support.yapla.com/it-it/gestire-i-membri?hsLang=it-it#formazione-continua) - [Domande frequenti](https://support.yapla.com/it-it/gestire-i-membri?hsLang=it-it#domande-frequenti) - [Organizzare i tuoi eventi](https://support.yapla.com/it-it/organizzare-i-tuoi-eventi?hsLang=it-it#main-content) - [Primi passi](https://support.yapla.com/it-it/organizzare-i-tuoi-eventi?hsLang=it-it#primi-passi) - [Configurazione](https://support.yapla.com/it-it/organizzare-i-tuoi-eventi?hsLang=it-it#configurazione) - [Moduli](https://support.yapla.com/it-it/organizzare-i-tuoi-eventi?hsLang=it-it#moduli) - [Biglietti elettronici](https://support.yapla.com/it-it/organizzare-i-tuoi-eventi?hsLang=it-it#biglietti-elettronici) - [Impostazioni avanzate](https://support.yapla.com/it-it/organizzare-i-tuoi-eventi?hsLang=it-it#impostazioni-avanzate) - [Comunicazioni](https://support.yapla.com/it-it/organizzare-i-tuoi-eventi?hsLang=it-it#comunicazioni) - [Gestione dei prezzi](https://support.yapla.com/it-it/organizzare-i-tuoi-eventi?hsLang=it-it#gestione-dei-prezzi) - [Gestione delle iscrizioni](https://support.yapla.com/it-it/organizzare-i-tuoi-eventi?hsLang=it-it#gestione-delle-iscrizioni) - [Gestione delle attività con le sessioni](https://support.yapla.com/it-it/organizzare-i-tuoi-eventi?hsLang=it-it#gestione-delle-attivit%C3%A0-con-le-sessioni) - [Congressi](https://support.yapla.com/it-it/organizzare-i-tuoi-eventi?hsLang=it-it#congressi) - [Domande frequenti](https://support.yapla.com/it-it/organizzare-i-tuoi-eventi?hsLang=it-it#domande-frequenti) - [Raccogliere donazioni](https://support.yapla.com/it-it/raccogliere-donazioni?hsLang=it-it#main-content) - [Primi passi](https://support.yapla.com/it-it/raccogliere-donazioni?hsLang=it-it#primi-passi) - [Gestione delle donazioni](https://support.yapla.com/it-it/raccogliere-donazioni?hsLang=it-it#gestione-delle-donazioni) - [Attestazioni di donazione](https://support.yapla.com/it-it/raccogliere-donazioni?hsLang=it-it#attestazioni-di-donazione) - [Donazioni ricorrenti](https://support.yapla.com/it-it/raccogliere-donazioni?hsLang=it-it#donazioni-ricorrenti) - [Gestione delle campagne](https://support.yapla.com/it-it/raccogliere-donazioni?hsLang=it-it#gestione-delle-campagne) - [Gestione delle campagne partecipative](https://support.yapla.com/it-it/raccogliere-donazioni?hsLang=it-it#gestione-delle-campagne-partecipative) - [Gestione dei donatori](https://support.yapla.com/it-it/raccogliere-donazioni?hsLang=it-it#gestione-dei-donatori) - [Domande frequenti](https://support.yapla.com/it-it/raccogliere-donazioni?hsLang=it-it#domande-frequenti) - [Creare il tuo sito web](https://support.yapla.com/it-it/creare-il-tuo-sito-web?hsLang=it-it#main-content) - [Primi passi](https://support.yapla.com/it-it/creare-il-tuo-sito-web?hsLang=it-it#primi-passi) - [Personalizzazione del sito web](https://support.yapla.com/it-it/creare-il-tuo-sito-web?hsLang=it-it#personalizzazione-del-sito-web) - [Pagine](https://support.yapla.com/it-it/creare-il-tuo-sito-web?hsLang=it-it#pagine) - [Moduli](https://support.yapla.com/it-it/creare-il-tuo-sito-web?hsLang=it-it#moduli) - [Gestione del contenuto e degli articoli](https://support.yapla.com/it-it/creare-il-tuo-sito-web?hsLang=it-it#gestione-del-contenuto-e-degli-articoli) - [SEO e strumenti di performance](https://support.yapla.com/it-it/creare-il-tuo-sito-web?hsLang=it-it#seo-e-strumenti-di-performance) - [Domande frequenti](https://support.yapla.com/it-it/creare-il-tuo-sito-web?hsLang=it-it#domande-frequenti) - [Semplificare la tua contabilità](https://support.yapla.com/it-it/semplificare-la-tua-contabilit%C3%A0?hsLang=it-it#main-content) - [Primi passi](https://support.yapla.com/it-it/semplificare-la-tua-contabilit%C3%A0?hsLang=it-it#primi-passi) - [Gestione dei ricavi](https://support.yapla.com/it-it/semplificare-la-tua-contabilit%C3%A0?hsLang=it-it#gestione-dei-ricavi) - [Gestione dei costi](https://support.yapla.com/it-it/semplificare-la-tua-contabilit%C3%A0?hsLang=it-it#gestione-dei-costi) - [Contabilità](https://support.yapla.com/it-it/semplificare-la-tua-contabilit%C3%A0?hsLang=it-it#contabilit%C3%A0) - [Registro generale](https://support.yapla.com/it-it/semplificare-la-tua-contabilit%C3%A0?hsLang=it-it#registro-generale) - [Consolidamento](https://support.yapla.com/it-it/semplificare-la-tua-contabilit%C3%A0?hsLang=it-it#consolidamento) - [Reportistica](https://support.yapla.com/it-it/semplificare-la-tua-contabilit%C3%A0?hsLang=it-it#reportistica) - [Impostazioni](https://support.yapla.com/it-it/semplificare-la-tua-contabilit%C3%A0?hsLang=it-it#impostazioni) - [Progetti](https://support.yapla.com/it-it/semplificare-la-tua-contabilit%C3%A0?hsLang=it-it#progetti) - [IVA e tasse](https://support.yapla.com/it-it/semplificare-la-tua-contabilit%C3%A0?hsLang=it-it#iva-e-tasse) - [Domande frequenti](https://support.yapla.com/it-it/semplificare-la-tua-contabilit%C3%A0?hsLang=it-it#domande-frequenti) - [Gestire i tuoi contatti](https://support.yapla.com/it-it/gestire-i-tuoi-contatti?hsLang=it-it#main-content) - [Gestione dei contatti](https://support.yapla.com/it-it/gestire-i-tuoi-contatti?hsLang=it-it#gestione-dei-contatti) - [Domande frequenti](https://support.yapla.com/it-it/gestire-i-tuoi-contatti?hsLang=it-it#domande-frequenti) - [Implementare le tue newsletter](https://support.yapla.com/it-it/implementare-le-tue-newsletter?hsLang=it-it#main-content) - [Introduzione a Yapla Newsletter](https://support.yapla.com/it-it/implementare-le-tue-newsletter?hsLang=it-it#introduzione-a-yapla-newsletter) - [Scopri Yapla Newsletters](https://support.yapla.com/it-it/implementare-le-tue-newsletter?hsLang=it-it#scopri-yapla-newsletters) - [Gestione dei contatti](https://support.yapla.com/it-it/implementare-le-tue-newsletter?hsLang=it-it#gestione-dei-contatti) - [Monitoraggio delle prestazioni](https://support.yapla.com/it-it/implementare-le-tue-newsletter?hsLang=it-it#monitoraggio-delle-prestazioni) - [Gestire i tuoi dati](https://support.yapla.com/it-it/gestire-i-tuoi-dati?hsLang=it-it#main-content) - [Primi passi](https://support.yapla.com/it-it/gestire-i-tuoi-dati?hsLang=it-it#primi-passi) - [Configurazione](https://support.yapla.com/it-it/gestire-i-tuoi-dati?hsLang=it-it#configurazione) - [Gestione degli oggetti](https://support.yapla.com/it-it/gestire-i-tuoi-dati?hsLang=it-it#gestione-degli-oggetti) - [Rapporti](https://support.yapla.com/it-it/gestire-i-tuoi-dati?hsLang=it-it#rapporti) - [Documentazione per gli sviluppatori](https://support.yapla.com/it-it/documentazione-per-gli-sviluppatori?hsLang=it-it#main-content) - [Funzioni avanzate](https://support.yapla.com/it-it/documentazione-per-gli-sviluppatori?hsLang=it-it#funzioni-avanzate) - [Gestire la tua federazione](https://support.yapla.com/it-it/gestire-la-tua-federazione?hsLang=it-it#main-content) - [Avvio](https://support.yapla.com/it-it/gestire-la-tua-federazione?hsLang=it-it#avvio) - Offerte - [Tariffe](https://www.yapla.com/it/tariffe) - [Offerta partner](https://www.yapla.com/it/offerta-partner) - [Servizi Professionali](https://www.yapla.com/it/servizi-professionali) - [Consulenza a ore](https://formations.yapla.fr/it/) - Risorse - [Centro di assistenza](https://support.yapla.com/it-it/) - [Yapla Academy](https://formazione.yapla.com/) - [Yapla Newsletter](https://www.yapla.com/it-it/newsletter-yapla) - Scoprire Yapla - [Demo e webinar](https://www.yapla.com/it/webinar-per-associazioni) - Azienda - [Chi siamo](https://www.yapla.com/it/chi-siamo) - [Contattaci](https://www.yapla.com/it/contatta-yapla) - [Diventa partner](https://www.yapla.com/it-it/programma-partner/) [![Yapla](https://support.yapla.com/hubfs/logo-yapla-fr.svg "Yapla")](https://www.yapla.com/) Copyright © 2013-2026, Yapla [Condizioni generali di utilizzo](https://www.yapla.com/it/condizioni-generali-utilizzo) | [Dati personali](https://www.yapla.com/it/dati-personali) | [Note legali](https://support.yapla.com/it/note-legali?hsLang=it-it)