{ "openapi": "3.0.1", "info": { "title": "Datasets", "description": "The dataset API gives access to all the data published by EFSA. The API returns the metadata in DCAT-AP standard format with the DOI link to download the dataset. A set of filters are available allowing to retrieve a list of the datasets of interests (for instance the newly published), or the full list could be retrieved in once. ", "version": "v1.0" }, "servers": [ { "url": "https://openscaie-dev.azure-api.net/datasets/v1.0" } ], "paths": { "/": { "post": { "summary": "search", "description": "This API allows to retrieve metadata of EFSA published Datasets. Metadata are expressed in DCAT_AP. \n\nIn order to retrieve metadata it is possible to execute a query on the main fields like title (dcterms:title), abstract (dcterms:description), digital object identifier (adms:Identifier), keywords (dcat:keyword), publication date (dcterms:issued).\n\nBelow you can find some example of query search. For a complete guide on query syntax refers to https://docs.microsoft.com/en-us/rest/api/searchservice/search-documents\n\nSearch all and retrieve first 10 datastes\n {\n \"search\":\"*\",\n \"top\": \"10\",\n \"skip\": \"0\",\n }\n\nSearch datasets by identifier\n {\n \"search\": \"\\\\\"10.5281/zenodo.3060680\\\\\"\", \n \"searchFields\":\"adms:Identifier\"\n }\n\n \nSearch datasets published after a specific date\n {\n \"top\": \"35\",\n \"skip\": \"0\",\n \"filter\" : \"dcterms:issued gt 2019-04-30T00:00:00Z\"\n } \n\nTo retrieve all versions of the same dataset, execute a query on the 'relation' metatdata, since it is common for all versions, for example\n\n{ \"search\": \"\\\\\"http://doi.org/10.5281/zenodo.1339343\\\\\"\", \"searchFields\":\"dcterms:relation\", \"count\":\"true\" }\n\nPlease note: an empty request will not return any metadata. Insert at least a parameter for example \"search\":\"*\"", "operationId": "5b3b21211bca79411931c538", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Body" }, "example": { "search": "*", "top": "3", "skip": "0" } } } }, "responses": { "200": { "description": "", "content": { "application/json": { "example": { "datasets": [ { "@context": { "adms": "http://www.w3.org/ns/adms#", "dcat": "http://www.w3.org/ns/dcat#", "dcatapop": "http://data.europa.eu/88u/ontology/dcatapop#", "dcterms": "http://purl.org/dc/terms/", "foaf": "http://xmlns.com/foaf/0.1/", "owl": "http://www.w3.org/2002/07/owl#", "rdf": "http://www.w3.org/1999/02/22-rdf-syntax-ns#", "rdfs": "http://www.w3.org/2000/01/rdf-schema#", "schema": "http://schema.org/", "skos": "http://www.w3.org/2004/02/skos/core#", "vcard": "http://www.w3.org/2006/vcard/ns#", "xsd": "http://www.w3.org/2001/XMLSchema#" }, "@graph": [ { "@id": "Kind-9c3db30fcf09ecb536467ad4524e9da0", "@type": "vcard:Kind", "vcard:hasEmail": "data.collection@efsa.europa.eu", "vcard_organization_name": [ "European Food Safety Authority", "European Centre for Disease Prevention and Control" ] }, { "@id": "10.5281/zenodo.2585938", "@type": "dcat:Dataset", "dcat:contactPoint": { "@id": "Kind-9c3db30fcf09ecb536467ad4524e9da0" }, "dcat:distribution": { "@id": "Distribution-9c3db30fcf09ecb536467ad4524e9da0" }, "dcat_keyword": [ "antimicrobial resistance", "zoonotic bacteria", "indicator bacteria", "ESBL", "resistance to antibiotics", "indicator species", "extended spectrum beta-lactamases" ], "dcat:landingPage": "http://doi.org/10.5281/zenodo.2585938", "dcat:theme": { "@id": "http://publications.europa.eu/resource/authority/data-theme/AGRI" }, "dcterms:description": "
All tables, figures and maps produced for the European Union Summary Report on Antimicrobial Resistance in Zoonotic and Indicator Bacteria from Humans, Animals and Food in 2017 are provided.
", "dcterms:issued": { "@type": "xsd:dateTime", "@value": "2019-02-20T00:00:00.0000000+00:00" }, "dcterms:language": { "@id": "http://publications.europa.eu/resource/authority/language/ENG" }, "dcterms:publisher": { "@id": "http://publications.europa.eu/resource/authority/corporate-body/EFSA" }, "dcterms:subject": { "@id": "http://eurovoc.europa.eu/6569" }, "dcterms:title": "Tables and Figures complementing the European Union Summary Report on Antimicrobial Resistance in Zoonotic and Indicator Bacteria from Humans, Animals and Food in 2017", "owl:versionInfo": "1", "dcterms:relation": { "@id": "http://doi.org/10.5281/zenodo.2562858" } }, { "@id": "10.5281/zenodo.2585938", "@type": "adms:Identifier", "adms:schemaAgency": "European Food Safety Agency", "dcterms:issued": { "@type": "xsd:dateTime", "@value": "2019-02-20T00:00:00.0000000+00:00" }, "skos:notation": { "@type": "http://purl.org/spar/datacite/doi", "@value": "10.5281/zenodo.2585938" } }, { "@id": "https://zenodo.org/communities/efsa-kj", "@type": "dcat:Catalog", "dcat:dataset": { "@id": "10.5281/zenodo.2585938" }, "dcatapop:isPartOfCatalog": { "@id": "https://zenodo.org/communities/efsa-kj" }, "dcterms:description": { "@language": "en", "@value": "The Knowledge Junction is a curated, open repository for the exchange of evidence and supporting materials used in food and feed safety risk assessments. Our aim is to improve transparency, reproducibility and evidence reuse." }, "dcterms:publisher": { "@id": "http://publications.europa.eu/resource/authority/corporate-body/EFSA" }, "dcterms:title": { "@language": "en", "@value": "Knowledge Junction" } }, { "@id": "http://publications.europa.eu/resource/authority/corporate-body/EFSA", "@type": "foaf:Agent", "foaf:name": "EFSA" }, { "@id": "Distribution-9c3db30fcf09ecb536467ad4524e9da0", "@type": "dcat:Distribution", "dcat:accessURL": { "@id": "http://doi.org/10.5281/zenodo.2585938" }, "dcterms:format": { "@id": "http://publications.europa.eu/resource/authority/file-type/HTML" }, "dcterms:license": { "@id": "http://publications.europa.eu/resource/authority/licence/CC_BY_4_0" }, "dcterms:title": "Tables and Figures complementing the European Union Summary Report on Antimicrobial Resistance in Zoonotic and Indicator Bacteria from Humans, Animals and Food in 2017", "dcterms:type": { "@id": "http://publications.europa.eu/resource/authority/distribution-type/DOWNLOADABLE_FILE" } } ] } ] } } } }, "400": { "description": "\"response\": {\n \"error\": {\n \"code\": \"\",\n \"message\": \"Invalid expression: Syntax error at position 38 in 'type eq 'Dataset' and dcterms_issued : 2018-01-19T00:00:00Z'.\\r\\nParameter name: $filter\"\n }\n}\n\n\"response\": {\n \"error\": {\n \"code\": \"\",\n \"message\": \"Invalid expression: Could not find a property named 'dcterms_issueds' on type 'search.document'.\\r\\nParameter name: $filter\"\n }\n}\n\n\"response\": {\n \"error\": {\n \"code\": \"\",\n \"message\": \"Illegal arguments in query request: dcterms_titles is not a searchable field.\"\n }\n}\n\n\"response\":{\n \"error\": {\n \"code\": \"\",\n \"message\": \"The request is invalid. Invalid JSON.\"\n }\n}", "content": { "application/json": { } } }, "401": { "description": "{\n \"statusCode\": 401,\n \"message\": \"Access denied due to missing subscription key. Make sure to include subscription key when making requests to an API.\"\n}", "content": { "application/json": { } } }, "500": { "description": "{\n \"statusCode\": 500,\n \"message\": \"Internal server error\",\n \"activityId\": \"742828c4-11c4-44fb-80aa-7415b4de3389\"\n}", "content": { "application/json": { } } } } } } }, "components": { "schemas": { "Body": { "example": " { \n\t\"search\": \"*\", \n\t\"top\":\"3\",\n\t\"skip\":\"0\"\n }" } }, "securitySchemes": { "apiKeyHeader": { "type": "apiKey", "name": "Ocp-Apim-Subscription-Key", "in": "header" }, "apiKeyQuery": { "type": "apiKey", "name": "subscription-key", "in": "query" } } }, "security": [ { "apiKeyHeader": [ ] }, { "apiKeyQuery": [ ] } ] }