Webové služby
Service ID | Název služby, popis | Verze | Typ1 | Datový model3 | WSDL2, 3 | Věcný popis |
---|---|---|---|---|---|---|
EH_PEH01A |
Předání dat evidence použití hnojiv Služba určená k předání dat evidence použití hnojiv. |
01A | PF |
prod
test |
prod
test |
Detail |
EH_CHEH01A |
Stažení chyb podání evidence použití hnojiv Služba slouží k získání údajů evidence použití hnojiv, které byly předány službou EH_PEH01A. Zároveň služba vrací výsledek podání a přehled chyb, které systém po příjmu podání vyhodnotil. |
01A | PF |
prod
test |
prod
test |
Detail |
EH_CISUSP01A |
Číselník - užitkové směry pěstování Služba vrací číselník užitkových směrů pěstování, který je nutný pro vytvoření requestu pro WS EH_PEH01A. |
01A | BA |
prod
test |
prod
test |
Detail |
EH_CISPRO01A |
Číselníky - produkty Služba vrací číselník produktů, který je nutný pro vytvoření requestu pro WS EH_PEH01A. |
01A | BA |
prod
test |
prod
test |
Detail |
EH_CISOZP01A |
Číselníky - odběrů živin plodinami Služba vrací číselník odběrů živin plodinami, který je nutný pro vytvoření requestu pro WS EH_PEH01A. |
01A | BA |
prod
test |
prod
test |
Detail |
-
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:
-
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. -
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. -
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. -
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. -
AppInfo - služby BA i PF
Nepovinný element, kam může konzument umístit specifikaci svého SW a použité verze.
-