VPD Playground: test interattivi

Utilizzare la VPD Playground per testare query GraphQL in modo interattivo contro il servizio VPD.

La VPD Playground è un'interfaccia web grafica che consente di scrivere ed eseguire query GraphQL contro il servizio VPD, senza dover scrivere codice o avviare un client HTTP. Ideale per esplorare lo schema, testare query e visualizzare rapidamente i risultati.

Accesso alla Playground

La Playground è disponibile sul sito web VPD:

AmbienteURLProduzionehttps://vpd.econnect.euAccettazionehttps://accp-vpd.econnect.eu

Sono necessarie credenziali OAuth2 valide per utilizzare la Playground. Effettui il login con le proprie credenziali client (scope vpd) per avviare una sessione.

Cosa si può fare con la Playground?

La Playground offre un editor con syntax highlighting e autocomplete per GraphQL. Si digita la query nel pannello sinistro e si visualizza il risultato direttamente nel pannello destro. Le principali funzionalità:

  • Esplorare lo schema: tramite il documentation explorer integrato si visualizzano tutti i campi, i tipi e i parametri di ricerca disponibili
  • Scrivere ed eseguire query: si digita una query, si preme il pulsante play e si visualizza il risultato come JSON
  • Utilizzare variabili: si definiscono variabili nel pannello variabili per rendere le query riutilizzabili
  • Ispezionare i risultati: il risultato JSON è direttamente leggibile nell'interfaccia
Eseguire una query

Apra la Playground, si autentichi con le proprie credenziali ed esegua ad esempio questa query:

{
  parties(name: "eConnect", country: "NL", maxResults: 3) {
    legalName
    partyIds {
      type
      value
    }
    locations {
      city
    }
  }
}

La risposta appare direttamente nel pannello destro. Si vedranno la denominazione legale, gli identificativi e la città di sede delle organizzazioni trovate.

Documentazione dello schema

Sul lato destro della Playground si trova il documentation explorer. Cliccando su un tipo o un campo si visualizzano i sottocampi disponibili. Questo è il modo più rapido per scoprire quali dati sono disponibili, senza consultare separatamente la documentazione API.

L'explorer mostra lo schema party completo, inclusi i tipi di campo, le descrizioni e l'indicazione se un campo è opzionale. Lo si utilizzi come riferimento nella costruzione delle proprie query.

Suggerimenti

Si consiglia di testare sempre prima nell'ambiente di accettazione (accp-vpd.econnect.eu) prima di eseguire query in produzione. Si utilizzi il parametro maxResults per limitare il numero di risultati durante i test. E si sfrutti l'autocomplete nell'editor: risparmia tempo di digitazione e previene errori nei nomi dei campi.


Desidera integrare strutturalmente la VPD nella propria applicazione? Legga come utilizzare la VPD nella propria integrazione.

Apri la VPD Playground

Correlati