Le VPD Playground est une interface web graphique qui vous permet d'écrire et d'exécuter des requêtes GraphQL contre le service VPD, sans avoir besoin d'écrire du code ni de lancer un client HTTP. Idéal pour explorer le schéma, tester des requêtes et consulter rapidement les résultats.

Le Playground est disponible sur le site web du VPD :

Vous avez besoin de credentials OAuth2 valides pour utiliser le Playground. Connectez-vous avec vos client credentials (scope vpd) pour démarrer une session.

Le Playground propose un éditeur avec coloration syntaxique et autocomplétion pour GraphQL. Vous saisissez votre requête dans le panneau de gauche et le résultat s'affiche directement dans le panneau de droite. Les principales fonctionnalités :

• Explorer le schéma : via l'explorateur de documentation intégré, vous visualisez tous les champs, types et paramètres de recherche disponibles
• Écrire et exécuter des requêtes : saisissez une requête, cliquez sur le bouton play et consultez le résultat en JSON
• Utiliser des variables : définissez des variables dans le panneau de variables pour rendre vos requêtes réutilisables
• Inspecter les résultats : le résultat JSON est directement lisible dans l'interface

Ouvrez le Playground, authentifiez-vous avec vos credentials et exécutez par exemple cette requête :

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

La réponse apparaît directement dans le panneau de droite. Vous y trouvez le nom juridique, les identifiants et la ville d'établissement des organisations trouvées.

Sur le côté droit du Playground, vous trouvez l'explorateur de documentation. Cliquez sur un type ou un champ pour voir les sous-champs disponibles. C'est la manière la plus rapide de découvrir quelles données sont disponibles, sans consulter séparément la documentation de l'API.

L'explorateur affiche le schéma party complet, y compris les types de champs, les descriptions et si un champ est optionnel. Utilisez-le comme référence lors de la construction de vos requêtes.

Testez toujours d'abord sur l'environnement d'acceptation (accp-vpd.econnect.eu) avant d'exécuter des requêtes en production. Utilisez le paramètre maxResults pour limiter le nombre de résultats pendant les tests. Et profitez de l'autocomplétion dans l'éditeur : cela vous fait gagner du temps et évite les erreurs dans les noms de champs.

Vous souhaitez intégrer le VPD de manière structurelle dans votre application ? Découvrez comment utiliser le VPD dans votre intégration.

• Aperçu VPD
• Schéma VPD : champs et requêtes
• Utiliser le VPD dans votre intégration

• Aperçu VPD
• Schéma VPD : champs et requêtes
• Utiliser le VPD dans votre intégration
• S'inscrire sur Peppol
• Facturation électronique avec eConnect