VPD Playground je grafické webové rozhranie, prostredníctvom ktorého môžete písať a spúšťať GraphQL dopyty voči službe VPD bez toho, aby ste museli písať kód alebo spúšťať HTTP klienta. Je ideálny na preskúmanie schémy, testovanie dopytov a rýchle prezeranie výsledkov.

Playground je dostupný na webovej stránke VPD:

Na používanie Playground potrebujete platné OAuth2 credentials. Prihláste sa pomocou svojich client credentials (scope vpd) a spustite reláciu.

Playground ponúka editor so zvýrazňovaním syntaxe a automatickým dopĺňaním pre GraphQL. Dopyt napíšete do ľavého panelu a výsledok uvidíte priamo v pravom paneli. Hlavné možnosti:

• Preskúmanie schémy: prostredníctvom vstavaného prieskumníka dokumentácie uvidíte všetky dostupné polia, typy a vyhľadávacie parametre
• Písanie a spúšťanie dopytov: napíšte dopyt, stlačte tlačidlo play a pozrite si výsledok ako JSON
• Používanie premenných: definujte premenné v paneli premenných, aby boli dopyty znovupoužiteľné
• Kontrola výsledkov: JSON výsledok je priamo čitateľný v rozhraní

Otvorte Playground, autentifikujte sa pomocou svojich credentials a vykonajte napríklad tento dopyt:

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

Odpoveď sa objaví priamo v pravom paneli. Uvidíte právny názov, identifikátory a mesto sídla nájdených organizácií.

Na pravej strane Playground nájdete prieskumník dokumentácie. Kliknite na typ alebo pole a zobrazia sa dostupné podpolia. Je to najrýchlejší spôsob, ako zistiť, aké dáta sú k dispozícii, bez toho, aby ste museli samostatne prezerať API dokumentáciu.

Prieskumník zobrazuje kompletné party schéma vrátane typov polí, popisov a informácie, či je pole voliteľné. Používajte ho ako referenčnú príručku pri vytváraní Vašich dopytov.

Testujte vždy najprv na akceptačnom prostredí (accp-vpd.econnect.eu) predtým, ako spustíte dopyty v produkcii. Použite parameter maxResults na obmedzenie počtu výsledkov počas testovania. A využívajte automatické dopĺňanie v editore: ušetrí Vám písanie a predíde chybám v názvoch polí.

Chcete VPD štruktúrne zabudovať do Vašej aplikácie? Prečítajte si, ako VPD použijete vo Vašej integrácii.

• Prehľad VPD
• Schéma VPD: polia a dotazy
• Používanie VPD vo vašej integrácii
• Registrácia na Peppol
• Elektronická fakturácia s eConnect