VPD Playground je grafické webové rozhraní, prostřednictvím kterého můžete psát a spouštět GraphQL dotazy vůči službě VPD bez toho, abyste museli psát kód nebo spouštět HTTP klienta. Je ideální pro prozkoumání schématu, testování dotazů a rychlé prohlížení výsledků.

Playground je dostupný na webové stránce VPD:

Pro používání Playground potřebujete platné OAuth2 credentials. Přihlaste se pomocí svých client credentials (scope vpd) a spusťte relaci.

Playground nabízí editor se zvýrazňováním syntaxe a automatickým doplňováním pro GraphQL. Dotaz napíšete do levého panelu a výsledek uvidíte přímo v pravém panelu. Hlavní možnosti:

• Prozkoumání schématu: prostřednictvím vestavěného průzkumníka dokumentace uvidíte všechna dostupná pole, typy a vyhledávací parametry
• Psaní a spouštění dotazů: napište dotaz, stiskněte tlačítko play a prohlédněte si výsledek jako JSON
• Používání proměnných: definujte proměnné v panelu proměnných, aby byly dotazy znovupoužitelné
• Kontrola výsledků: JSON výsledek je přímo čitelný v rozhraní

Otevřete Playground, autentizujte se pomocí svých credentials a proveďte například tento dotaz:

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

Odpověď se objeví přímo v pravém panelu. Uvidíte právní název, identifikátory a město sídla nalezených organizací.

Na pravé straně Playground naleznete průzkumník dokumentace. Klikněte na typ nebo pole a zobrazí se dostupná podpole. Je to nejrychlejší způsob, jak zjistit, jaká data jsou k dispozici, aniž byste museli samostatně procházet API dokumentaci.

Průzkumník zobrazuje kompletní party schéma včetně typů polí, popisů a informace, zda je pole volitelné. Používejte ho jako referenční příručku při vytváření Vašich dotazů.

Testujte vždy nejprve na akceptačním prostředí (accp-vpd.econnect.eu) předtím, než spustíte dotazy v produkci. Použijte parametr maxResults pro omezení počtu výsledků během testování. A využívejte automatické doplňování v editoru: ušetří Vám psaní a předejde chybám v názvech polí.

Chcete VPD strukturně zabudovat do Vaší aplikace? Přečtěte si, jak VPD použijete ve Vaší integraci.

• Přehled VPD
• Schéma VPD: pole a dotazy
• Používání VPD ve vaší integraci
• Registrace na Peppol
• Elektronická fakturace s eConnect