Catalogues
API change historyCatalogues (Harmonized controlled terminology) are a key element in the process of data validation and reporting. A harmonized terminology is used to collect and analyse data in a coherent way with the aim to support scientific research.
This API allows to retrieve the catalogues published on Data Collection Framework.
getCatalogueList
This operation allows downloading the list of catalogues, possibly restricted to a certain catalogue group or data collection.
Download catalogues for a data collection
To obtain the catalogues related to a data collection the getCatalogueList method must be invoked passing as parameter (arg1) the data collection code and setting the output type (arg2) as XML. The web service replies with a message containing the list of catalogues in XML format. If the data Collection does not exist then operation reply with the following soap message: Invalid data collection code.
Download catalogues in a group
To obtain the catalogues in a group the getCatalogueList method must be invoked passing as parameter (arg0) the catalogue group code and the format of the output (arg2) as XML. The web service replies with a message containing the list of catalogues in XML format.
Try itRequest
Request URL
Request headers
-
(optional)stringMedia type of the body sent to the API.
-
(optional)
Request body
getCatalogueList
<?xml version="1.0" encoding="utf-8"?>
<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/">
<Body>
<getCatalogueList xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://ws.catalog.dc.efsa.europa.eu/">
<arg0 xmlns="">Geographical distribution</arg0>
<arg1 xmlns=""></arg1>
<arg2 xmlns="">XML</arg2>
</getCatalogueList>
</Body>
</Envelope>
<xsd:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:tns="http://ws.catalog.dc.efsa.europa.eu/" attributeFormDefault="unqualified" elementFormDefault="unqualified" targetNamespace="http://ws.catalog.dc.efsa.europa.eu/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:ns1="http://schemas.xmlsoap.org/soap/http" xmlns:apim-wsdltns="http://ws.catalog.dc.efsa.europa.eu/">
<xsd:element name="ExportCatalogueFile" type="tns:ExportCatalogueFile" />
<xsd:element name="ExportCatalogueFileResponse" type="tns:ExportCatalogueFileResponse" />
<xsd:element name="getCatalogueGroupList" type="tns:getCatalogueGroupList" />
<xsd:element name="getCatalogueGroupListResponse" type="tns:getCatalogueGroupListResponse" />
<xsd:element name="getCatalogueList" type="tns:getCatalogueList" />
<xsd:element name="getCatalogueListResponse" type="tns:getCatalogueListResponse" />
<xsd:complexType name="getCatalogueList">
<xsd:sequence>
<xsd:element minOccurs="0" name="arg0" type="xs:string" />
<xsd:element minOccurs="0" name="arg1" type="xs:string" />
<xsd:element minOccurs="0" name="arg2" type="xs:string" />
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="getCatalogueListResponse">
<xsd:sequence>
<xsd:element minOccurs="0" name="return" type="xs:string" />
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="getCatalogueGroupList">
<xsd:sequence />
</xsd:complexType>
<xsd:complexType name="getCatalogueGroupListResponse">
<xsd:sequence>
<xsd:element minOccurs="0" name="return" type="xs:string" />
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="ExportCatalogueFile">
<xsd:sequence>
<xsd:element minOccurs="0" name="catalogueCode" type="xs:string" />
<xsd:element minOccurs="0" name="catalogueVersion" type="xs:string" />
<xsd:element minOccurs="0" name="exportType" type="xs:string" />
<xsd:element minOccurs="0" name="group" type="xs:string" />
<xsd:element minOccurs="0" name="dcCode" type="xs:string" />
<xsd:element minOccurs="0" name="fileType" type="xs:string" />
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="ExportCatalogueFileResponse">
<xsd:sequence>
<xsd:element minOccurs="0" name="return" type="tns:catalogueFile" />
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="catalogueFile">
<xsd:sequence>
<xsd:element xmlns:ns2="http://www.w3.org/2005/05/xmlmime" minOccurs="0" name="fileHandler" ns2:expectedContentTypes="application/octet-stream" type="xs:base64Binary" />
<xsd:element minOccurs="0" name="filename" type="xs:string" />
<xsd:element name="isZipped" type="xs:boolean" />
<xsd:element minOccurs="0" name="filetype" type="xs:string" />
</xsd:sequence>
</xsd:complexType>
<xsd:element name="WsUploadException" type="tns:WsUploadException" />
<xsd:complexType name="WsUploadException">
<xsd:sequence />
</xsd:complexType>
</xsd:schema>
Responses
200 OK
getCatalogueListResponse
Representations
<?xml version="1.0" encoding="utf-8"?>
<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/">
<Body>
<getCatalogueListResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://ws.catalog.dc.efsa.europa.eu/">
<return xmlns="">return1</return>
</getCatalogueListResponse>
</Body>
</Envelope>
<xsd:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:tns="http://ws.catalog.dc.efsa.europa.eu/" attributeFormDefault="unqualified" elementFormDefault="unqualified" targetNamespace="http://ws.catalog.dc.efsa.europa.eu/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:ns1="http://schemas.xmlsoap.org/soap/http" xmlns:apim-wsdltns="http://ws.catalog.dc.efsa.europa.eu/">
<xsd:element name="ExportCatalogueFile" type="tns:ExportCatalogueFile" />
<xsd:element name="ExportCatalogueFileResponse" type="tns:ExportCatalogueFileResponse" />
<xsd:element name="getCatalogueGroupList" type="tns:getCatalogueGroupList" />
<xsd:element name="getCatalogueGroupListResponse" type="tns:getCatalogueGroupListResponse" />
<xsd:element name="getCatalogueList" type="tns:getCatalogueList" />
<xsd:element name="getCatalogueListResponse" type="tns:getCatalogueListResponse" />
<xsd:complexType name="getCatalogueList">
<xsd:sequence>
<xsd:element minOccurs="0" name="arg0" type="xs:string" />
<xsd:element minOccurs="0" name="arg1" type="xs:string" />
<xsd:element minOccurs="0" name="arg2" type="xs:string" />
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="getCatalogueListResponse">
<xsd:sequence>
<xsd:element minOccurs="0" name="return" type="xs:string" />
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="getCatalogueGroupList">
<xsd:sequence />
</xsd:complexType>
<xsd:complexType name="getCatalogueGroupListResponse">
<xsd:sequence>
<xsd:element minOccurs="0" name="return" type="xs:string" />
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="ExportCatalogueFile">
<xsd:sequence>
<xsd:element minOccurs="0" name="catalogueCode" type="xs:string" />
<xsd:element minOccurs="0" name="catalogueVersion" type="xs:string" />
<xsd:element minOccurs="0" name="exportType" type="xs:string" />
<xsd:element minOccurs="0" name="group" type="xs:string" />
<xsd:element minOccurs="0" name="dcCode" type="xs:string" />
<xsd:element minOccurs="0" name="fileType" type="xs:string" />
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="ExportCatalogueFileResponse">
<xsd:sequence>
<xsd:element minOccurs="0" name="return" type="tns:catalogueFile" />
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="catalogueFile">
<xsd:sequence>
<xsd:element xmlns:ns2="http://www.w3.org/2005/05/xmlmime" minOccurs="0" name="fileHandler" ns2:expectedContentTypes="application/octet-stream" type="xs:base64Binary" />
<xsd:element minOccurs="0" name="filename" type="xs:string" />
<xsd:element name="isZipped" type="xs:boolean" />
<xsd:element minOccurs="0" name="filetype" type="xs:string" />
</xsd:sequence>
</xsd:complexType>
<xsd:element name="WsUploadException" type="tns:WsUploadException" />
<xsd:complexType name="WsUploadException">
<xsd:sequence />
</xsd:complexType>
</xsd:schema>