Typ služby - zabezpečení

• BA - bez autorizace (služba nevyžaduje žádný prvek autorizace). Služba je volně dostupná veřejnosti.
• PF - služba vyžaduje autorizaci minimálně na úrovni loginu do portálu farmáře a WS klíče
  (ve formátu vOKO_wss_token.xml (1 kB)), je možné použít i elektronický podpis (ve formátu xml:Signature). O zřízení přístupu do PF eAGRI lze požádat dle následujícího postupu. Postup tvorby hash je uveden zde. Ověření/vytvoření tokenu pro konkrétní request je možné provést na této stránce.

prod/test - obsah políčka u příslušné služby říká, zda je aktuálně daná služba vystavena na testovacím či produkčním prostředí, nebo na obou prostředích. Pokud je u dané služby v příslušném políčku k dispozici "WSDL" (je zde uveden text "WSDL", který zároveň slouží jako odkaz k jeho stažení), pak je služba na daném prostředí vystavena.

Důležité upozornění! Mozilla Firefox (a některé další prohlížeče) nezobrazují XML korektně. Více informací najdete na stránce postupy.

Informace ke specifickým elementům v requestu služeb:

1. SERVICEID - služby BA i PF
   Požadovaná služba se rozlišuje hodnotou parametrem SERVICEID uvnitř každé zprávy (requestu). Tedy: Volání příslušné služby provedete tak, že její identifikátor (např. LPI_DDP01A) vložíte do parametru SERVICEID.

2. subjectID - služby PF
   Do elementu Subject se vkládá povinný atribut subjectID, který obsahuje SZRID, které přidělilo MZe nebo SZIF v rámci registrace firmy do Portálu farmáře eAGRI. Hodnota SZRID je k dispozici po přihlášení do PF eAGRI.cz a po kliknutí na uživatelské jméno v horním pravém rohu.

3. UIDkey - služba PF
   Do elementu UIDkey se vkládá povinný atribut přiděleného přidělení login uživatele - 99xxx nebo 98xxx.

4. RequestID - služby BA i PF
   Jedná se o nepovinný element, který umožňuje "označkovat" request volitelným identifikátorem ze strany informačního systému subjektu. Hodnota se potom vrací v odpovědi služby.

5. AppInfo - služby BA i PF
   Nepovinný element, kam může konzument umístit specifikaci svého SW a použité verze.