{
"variable": [
{
"id": "baseUrl",
"key": "baseUrl",
"type": "string",
"name": "string",
"value": "https:\/\/app.pollinatorhub.eu"
}
],
"info": {
"name": "EU Pollinator Hub API",
"_postman_id": "33a64248-4408-4539-bf3a-9877dcc0964f",
"description": "The EU Pollinator Hub is an integrative tool to centralise, analyse and visualise bee and pollinator-related data based on principles of collaboration and conservation.
\nBees and other insect pollinators are becoming increasingly relevant in the public debate. European authorities now recognise the environmental risks pollinators face and the need for institutional action. Given their importance for ecosystems and their role in our food security, the commitment to protect pollinators has been growing, and data is essential to fulfilling this commitment.
\nDifferent agents and stakeholders are continually collecting data related to the status of pollinators, such as researchers, environmental, health or agricultural authorities, national beekeeping or farming associations. The EU Pollinator Hub has been conceived to valorise their efforts and improve collaborations based on data-sharing. At the same time, the EU Pollinator Hub is constantly developing to provide access to valuable data from different consenting sources. In a collaborative spirit, the EU Pollinator Hub centralises and presents this data, also working as a communicative tool for the benefit of bees and pollinators in general.
\nThe EU Pollinator Hub is coordinated by BeeLife European Beekeeping Coordination, an NGO focused on the protection of pollinators and biodiversity in Europe. BeeLife has initialised the first stages of this integrative platform within the Internet of Bees (IoBee) project.
\nThe EU Pollinator Hub is also an attempt to materialise the conclusions of the EU Bee Partnership regarding the need for further bee-data integration. The partnership is a stakeholder platform dynamised by the European Food Safety Authority that includes representatives from the beekeeping and farming sectors, NGOs, veterinarians, academia, industry, producers, and scientists.
\nThis new tool also includes developments from the Apimondia working group on the standardisation of data on bees - Bee XML. Bee XML is the ongoing measure to reach a new model for sharing bee data, and the EU Pollinator Hub aims at implementing these standards.",
"schema": "https:\/\/schema.getpostman.com\/json\/collection\/v2.1.0\/collection.json"
},
"item": [
{
"name": "Entities",
"description": "\nThis route will allow modifications to the meta-data for the Entities.\nIt includes basic information like name, description and contact information.\nIt directly \u201cowns\u201d datasets.\nIt is identified by UID which is created during the data entity creation procedure.",
"item": [
{
"name": "Show Entities",
"request": {
"url": {
"host": "{{baseUrl}}",
"path": "api\/v1\/entities",
"query": [],
"raw": "{{baseUrl}}\/api\/v1\/entities"
},
"method": "GET",
"header": [
{
"key": "Content-Type",
"value": "application\/json"
},
{
"key": "Accept",
"value": "application\/json"
}
],
"body": null,
"description": "Display a listing of Entities, the User has access to."
},
"response": [
{
"header": [],
"code": 200,
"body": "{\n \"data\": [\n {\n \"name\": \"EU Pollinator Hub\",\n \"uid\": \"euph\",\n \"contact\": [\n {\n \"type\": \"url\",\n \"value\": \"https:\/\/pollinatorhub.eu\"\n },\n {\n \"type\": \"email\",\n \"value\": \"hello@pollinatorhub.eu\"\n }\n ],\n \"abbreviation\": \"EUPH\",\n \"registry_number\": \"N\/A\",\n \"description\": \"The EU Pollinator Hub is a data hub related to pollinators, which is provided by the European Food Safety Authority (EFSA).\",\n \"address\": \"N\/A\",\n \"country\": {\n \"iso-3166-country-name\": \"the Kingdom of Belgium\",\n \"iso-3166-numeric-country-code\": \"56\",\n \"iso-3166-country-name-short-lc\": \"Belgium\",\n \"iso-3166-alpha-2-country\": \"BE\",\n \"iso-3166-alpha-3-country\": \"BEL\"\n },\n \"user_id\": 1,\n \"created_at\": \"2023-07-04T11:24:58.000000Z\",\n \"updated_at\": \"2023-07-04T11:25:00.000000Z\"\n },\n}",
"name": ""
},
{
"header": [],
"code": 400,
"body": "",
"name": "Bad Request"
},
{
"header": [],
"code": 401,
"body": "",
"name": "Unauthorized"
},
{
"header": [],
"code": 403,
"body": "",
"name": "Forbidden"
},
{
"header": [],
"code": 500,
"body": "",
"name": "Internal server error"
}
]
},
{
"name": "Create Entity",
"request": {
"url": {
"host": "{{baseUrl}}",
"path": "api\/v1\/entities",
"query": [],
"raw": "{{baseUrl}}\/api\/v1\/entities"
},
"method": "POST",
"header": [
{
"key": "Content-Type",
"value": "application\/json"
},
{
"key": "Accept",
"value": "application\/json"
}
],
"body": {
"mode": "raw",
"raw": "{\"name\":\"European Food Safety Authority\",\"abbreviation\":\"EFSA\",\"description\":\"No-example\",\"user_id\":8,\"country_id\":\"IT\",\"type\":\"legal-entity\"}"
},
"description": "Store an Entity in storage."
},
"response": [
{
"header": [],
"code": 200,
"body": "{}",
"name": ""
}
]
},
{
"name": "Show Entity",
"request": {
"url": {
"host": "{{baseUrl}}",
"path": "api\/v1\/entities\/:id",
"query": [],
"raw": "{{baseUrl}}\/api\/v1\/entities\/:id",
"variable": [
{
"id": "id",
"key": "id",
"value": "3",
"description": "The unique identifier used to identify the Entity within the platform."
}
]
},
"method": "GET",
"header": [
{
"key": "Content-Type",
"value": "application\/json"
},
{
"key": "Accept",
"value": "application\/json"
}
],
"body": null,
"description": "Display the specified Entity."
},
"response": [
{
"header": [],
"code": 200,
"body": "{\n \"name\": \"EU Pollinator Hub\",\n \"uid\": \"euph\",\n \"contact\": [\n {\n \"type\": \"url\",\n \"value\": \"https:\/\/pollinatorhub.eu\"\n },\n {\n \"type\": \"email\",\n \"value\": \"hello@pollinatorhub.eu\"\n }\n ],\n \"abbreviation\": \"EUPH\",\n \"registry_number\": \"N\/A\",\n \"description\": \"The EU Pollinator Hub is a data hub related to pollinators, which is provided by the European Food Safety Authority (EFSA).\",\n \"address\": \"N\/A\",\n \"country\": {\n \"iso-3166-country-name\": \"the Kingdom of Belgium\",\n \"iso-3166-numeric-country-code\": \"56\",\n \"iso-3166-country-name-short-lc\": \"Belgium\",\n \"iso-3166-alpha-2-country\": \"BE\",\n \"iso-3166-alpha-3-country\": \"BEL\"\n },\n \"user_id\": 1,\n \"created_at\": \"2023-07-04T11:24:58.000000Z\",\n \"updated_at\": \"2023-07-04T11:25:00.000000Z\"\n}",
"name": ""
}
]
},
{
"name": "Update Entity",
"request": {
"url": {
"host": "{{baseUrl}}",
"path": "api\/v1\/entities\/:id",
"query": [],
"raw": "{{baseUrl}}\/api\/v1\/entities\/:id",
"variable": [
{
"id": "id",
"key": "id",
"value": "eum",
"description": "The ID of the entity."
},
{
"id": "uid",
"key": "uid",
"value": "euph",
"description": "The unique identifier used to identify the Entity within the platform."
}
]
},
"method": "PUT",
"header": [
{
"key": "Content-Type",
"value": "application\/json"
},
{
"key": "Accept",
"value": "application\/json"
}
],
"body": {
"mode": "raw",
"raw": "{\"name\":\"European Food Safety Authority\",\"abbreviation\":\"EFSA\",\"description\":\"No-example\",\"user_id\":0,\"country_id\":\"IT\",\"contact\":[{\"type\":\"email\",\"value\":\"example@pollinatorhub.eu\"}]}"
},
"description": "Update the specified Entity in storage."
},
"response": [
{
"header": [],
"code": 200,
"body": "{}",
"name": ""
}
]
},
{
"name": "Delete Entity",
"request": {
"url": {
"host": "{{baseUrl}}",
"path": "api\/v1\/entities\/:id",
"query": [],
"raw": "{{baseUrl}}\/api\/v1\/entities\/:id",
"variable": [
{
"id": "id",
"key": "id",
"value": "possimus",
"description": "The ID of the entity."
},
{
"id": "uid",
"key": "uid",
"value": "euph",
"description": "The unique identifier used to identify the Entity within the platform."
}
]
},
"method": "DELETE",
"header": [
{
"key": "Content-Type",
"value": "application\/json"
},
{
"key": "Accept",
"value": "application\/json"
}
],
"body": null,
"description": "Remove the specified Entity from storage."
},
"response": [
{
"header": [],
"code": 204,
"body": "{}",
"name": ""
}
]
}
]
},
{
"name": "Datasets",
"description": "\nThis route will allow modifications to the meta-data for the Datasets.\nIt includes basic information like name, description and contact information.\nIt is owned by one or more entities. It directly owns one or more Dataset Parts.\nIt is identified by UID which is created during the data entity creation procedure.",
"item": [
{
"name": "Show Datasets",
"request": {
"url": {
"host": "{{baseUrl}}",
"path": "api\/v1\/datasets",
"query": [
{
"key": "entity",
"value": "euph",
"description": "Filter datasets by Entity uid.",
"disabled": false
}
],
"raw": "{{baseUrl}}\/api\/v1\/datasets?entity=euph"
},
"method": "GET",
"header": [
{
"key": "Content-Type",
"value": "application\/json"
},
{
"key": "Accept",
"value": "application\/json"
}
],
"body": null,
"description": "Display a listing of the Datasets, the User has access to.."
},
"response": [
{
"header": [],
"code": 200,
"body": "{\n \"data\": [\n {\n \"entities\": [\n \"euph\"\n ],\n \"name\": \"EUPH Reference dataset containing licences\",\n \"long_name\": \"EUPH Reference dataset containing licences\",\n \"number\": \"000026\",\n \"slug\": \"licences\",\n \"uid\": \"licences\",\n \"description\": \"The dataset contains all licences for data hosted on the EUPH.\",\n \"status\": \"publish\",\n \"public\": true,\n \"licence\": \"cc-by\",\n \"published_at\": null\n },\n ]\n}",
"name": ""
},
{
"header": [],
"code": 400,
"body": "",
"name": "Bad Request"
},
{
"header": [],
"code": 401,
"body": "",
"name": "Unauthorized"
},
{
"header": [],
"code": 403,
"body": "",
"name": "Forbidden"
},
{
"header": [],
"code": 500,
"body": "",
"name": "Internal server error"
}
]
},
{
"name": "Create Dataset",
"request": {
"url": {
"host": "{{baseUrl}}",
"path": "api\/v1\/datasets",
"query": [],
"raw": "{{baseUrl}}\/api\/v1\/datasets"
},
"method": "POST",
"header": [
{
"key": "Content-Type",
"value": "application\/json"
},
{
"key": "Accept",
"value": "application\/json"
}
],
"body": {
"mode": "raw",
"raw": "{\"entities\":[\"euph\"],\"name\":\"ISO 3166-1:2020\",\"long_name\":\"ouzsjgmyeaylblvcbyxqqlfpehpjigwxwtbnagckmdzfqignyaojxiatjhucvbjmifcwby\",\"description\":\"Suscipit doloribus fugiat voluptas vero cupiditate quaerat neque.\",\"status\":\"pending\",\"public\":true,\"licence\":\"cc-by\",\"published_at\":\"2023-07-04T11:24:58.000000Z\"}"
},
"description": "Store a Dataset in storage."
},
"response": [
{
"header": [],
"code": 200,
"body": "{}",
"name": ""
}
]
},
{
"name": "Show Dataset",
"request": {
"url": {
"host": "{{baseUrl}}",
"path": "api\/v1\/datasets\/:id",
"query": [],
"raw": "{{baseUrl}}\/api\/v1\/datasets\/:id",
"variable": [
{
"id": "id",
"key": "id",
"value": "1",
"description": "The ID of the dataset."
},
{
"id": "uid",
"key": "uid",
"value": "countries",
"description": "The unique identifier used to identify the Dataset within the platform."
}
]
},
"method": "GET",
"header": [
{
"key": "Content-Type",
"value": "application\/json"
},
{
"key": "Accept",
"value": "application\/json"
}
],
"body": null,
"description": "Display the specified Dataset."
},
"response": [
{
"header": [
{
"key": "cache-control",
"value": "no-cache, private"
},
{
"key": "content-type",
"value": "application\/json"
},
{
"key": "x-ratelimit-limit",
"value": "60"
},
{
"key": "x-ratelimit-remaining",
"value": "59"
},
{
"key": "access-control-allow-origin",
"value": "*"
}
],
"code": 200,
"body": "{\"data\":{\"name\":\"EUPH\",\"long_name\":\"EUPH\",\"number\":\"000001\",\"uid\":\"EUPHA1.0.0\",\"description\":\"This dataset contains the basic data created for the platform to function.\",\"entities\":[\"euph\"],\"contact\":[],\"licence\":\"euph\",\"published_at\":null,\"created_at\":\"2023-09-01T08:53:36.000000Z\",\"updated_at\":\"2024-04-05T17:46:43.000000Z\"}}",
"name": ""
}
]
},
{
"name": "Update Dataset",
"request": {
"url": {
"host": "{{baseUrl}}",
"path": "api\/v1\/datasets\/:id",
"query": [],
"raw": "{{baseUrl}}\/api\/v1\/datasets\/:id",
"variable": [
{
"id": "id",
"key": "id",
"value": "1",
"description": "The ID of the dataset."
},
{
"id": "uid",
"key": "uid",
"value": "countries",
"description": "The unique identifier used to identify the Dataset within the platform."
}
]
},
"method": "PUT",
"header": [
{
"key": "Content-Type",
"value": "application\/json"
},
{
"key": "Accept",
"value": "application\/json"
}
],
"body": {
"mode": "raw",
"raw": "{\"entities\":[\"euph\"],\"name\":\"ISO 3166-1:2020\",\"long_name\":\"No-example\",\"description\":\"No-example\",\"status\":\"pending\",\"licence\":\"cc-by\",\"public\":true,\"published_at\":\"2023-07-04T11:24:58.000000Z\"}"
},
"description": "Update the specified Dataset in storage."
},
"response": [
{
"header": [],
"code": 200,
"body": "{}",
"name": ""
}
]
},
{
"name": "Delete Dataset",
"request": {
"url": {
"host": "{{baseUrl}}",
"path": "api\/v1\/datasets\/:id",
"query": [],
"raw": "{{baseUrl}}\/api\/v1\/datasets\/:id",
"variable": [
{
"id": "id",
"key": "id",
"value": "1",
"description": "The ID of the dataset."
},
{
"id": "uid",
"key": "uid",
"value": "countries",
"description": "The unique identifier used to identify the Dataset within the platform."
}
]
},
"method": "DELETE",
"header": [
{
"key": "Content-Type",
"value": "application\/json"
},
{
"key": "Accept",
"value": "application\/json"
}
],
"body": null,
"description": "Remove the specified Dataset from storage."
},
"response": [
{
"header": [],
"code": 204,
"body": "{}",
"name": ""
}
]
}
]
},
{
"name": "Dataset Parts",
"description": "",
"item": [
{
"name": "Show Dataset Parts",
"request": {
"url": {
"host": "{{baseUrl}}",
"path": "api\/v1\/datasets\/:dataset_id\/parts",
"query": [],
"raw": "{{baseUrl}}\/api\/v1\/datasets\/:dataset_id\/parts",
"variable": [
{
"id": "dataset_id",
"key": "dataset_id",
"value": "1",
"description": "The ID of the dataset."
},
{
"id": "dataset_uid",
"key": "dataset_uid",
"value": "",
"description": "The UID of the dataset to display related parts of."
}
]
},
"method": "GET",
"header": [
{
"key": "Content-Type",
"value": "application\/json"
},
{
"key": "Accept",
"value": "application\/json"
}
],
"body": null,
"description": "Display a listing of Dataset Parts, the User has access to."
},
"response": [
{
"header": [],
"code": 200,
"body": "{\n \"data\": [\n {\n \"name\": \"ISO 3166-1:2020\",\n \"description\": \"File iso3166_1_2020.csv contains 291 records of countries included in the ISO standard 3166-1:2020...\",\n \"uid\": \"DTST1.PRTA1.0\",\n \"type\": \"file\",\n \"licence_id\": \"unlicenced\",\n \"created_at\": \"2023-07-04T11:24:58.000000Z\",\n \"updated_at\": \"2023-07-04T11:24:58.000000Z\"\n }\n ]\n }",
"name": ""
}
]
},
{
"name": "Create Dataset Part.",
"request": {
"url": {
"host": "{{baseUrl}}",
"path": "api\/v1\/datasets\/:dataset_id\/parts",
"query": [],
"raw": "{{baseUrl}}\/api\/v1\/datasets\/:dataset_id\/parts",
"variable": [
{
"id": "dataset_id",
"key": "dataset_id",
"value": "1",
"description": "The ID of the dataset."
}
]
},
"method": "POST",
"header": [
{
"key": "Content-Type",
"value": "application\/json"
},
{
"key": "Accept",
"value": "application\/json"
}
],
"body": {
"mode": "raw",
"raw": "{\"name\":\"ISO 3166-1:2020\",\"description\":\"No-example\",\"type\":\"api\"}"
},
"description": "Store a Dataset Part in storage."
},
"response": [
{
"header": [
{
"key": "cache-control",
"value": "no-cache, private"
},
{
"key": "content-type",
"value": "application\/json"
},
{
"key": "x-ratelimit-limit",
"value": "60"
},
{
"key": "x-ratelimit-remaining",
"value": "58"
},
{
"key": "access-control-allow-origin",
"value": "*"
}
],
"code": 201,
"body": "{\"data\":{\"name\":\"ISO 3166-1:2020\",\"description\":\"No-example\",\"type\":\"api\",\"licence\":null,\"dataset_uid\":\"EUPHA1.0.0\",\"published_at\":null,\"created_at\":\"2024-07-10T11:53:18.000000Z\",\"updated_at\":\"2024-07-10T11:53:18.000000Z\"}}",
"name": ""
}
]
},
{
"name": "Display the specified resource.",
"request": {
"url": {
"host": "{{baseUrl}}",
"path": "api\/v1\/parts\/:id",
"query": [],
"raw": "{{baseUrl}}\/api\/v1\/parts\/:id",
"variable": [
{
"id": "id",
"key": "id",
"value": "1",
"description": "The numeric identifier used to identify the Dataset Part within the platform."
}
]
},
"method": "GET",
"header": [
{
"key": "Content-Type",
"value": "application\/json"
},
{
"key": "Accept",
"value": "application\/json"
}
],
"body": null,
"description": ""
},
"response": [
{
"header": [
{
"key": "cache-control",
"value": "no-cache, private"
},
{
"key": "content-type",
"value": "application\/json"
},
{
"key": "x-ratelimit-limit",
"value": "60"
},
{
"key": "x-ratelimit-remaining",
"value": "57"
},
{
"key": "access-control-allow-origin",
"value": "*"
}
],
"code": 200,
"body": "{\"data\":{\"name\":\"ISO 3166:2020\",\"description\":\"Data in this table was obtained from the International Organization for Standardization (ISO) Data, an independent, non-governmental international organization with a membership of 167 national standards bodies. It contains codes and names for the representation of names of countries and their subdivisions.\",\"type\":\"file\",\"licence\":\"euph\",\"dataset_uid\":\"CNTRS2.0.0\",\"published_at\":null,\"created_at\":\"2023-01-26T18:18:14.000000Z\",\"updated_at\":\"2024-01-26T17:32:58.000000Z\"}}",
"name": ""
}
]
},
{
"name": "Update the specified resource in storage.",
"request": {
"url": {
"host": "{{baseUrl}}",
"path": "api\/v1\/parts\/:id",
"query": [],
"raw": "{{baseUrl}}\/api\/v1\/parts\/:id",
"variable": [
{
"id": "id",
"key": "id",
"value": "1",
"description": "The numeric identifier used to identify the Dataset Part within the platform."
}
]
},
"method": "PUT",
"header": [
{
"key": "Content-Type",
"value": "application\/json"
},
{
"key": "Accept",
"value": "application\/json"
}
],
"body": {
"mode": "raw",
"raw": "{\"entities\":[\"euph\"],\"name\":\"ISO 3166-1:2020\",\"description\":\"No-example\",\"type\":\"api\"}"
},
"description": ""
},
"response": [
{
"header": [
{
"key": "content-type",
"value": "text\/html; charset=UTF-8"
},
{
"key": "cache-control",
"value": "no-cache, private"
},
{
"key": "x-ratelimit-limit",
"value": "60"
},
{
"key": "x-ratelimit-remaining",
"value": "56"
},
{
"key": "access-control-allow-origin",
"value": "*"
}
],
"code": 200,
"body": "",
"name": ""
}
]
},
{
"name": "Remove the specified resource from storage.",
"request": {
"url": {
"host": "{{baseUrl}}",
"path": "api\/v1\/parts\/:id",
"query": [],
"raw": "{{baseUrl}}\/api\/v1\/parts\/:id",
"variable": [
{
"id": "id",
"key": "id",
"value": "1",
"description": "The numeric identifier used to identify the Dataset Part within the platform."
}
]
},
"method": "DELETE",
"header": [
{
"key": "Content-Type",
"value": "application\/json"
},
{
"key": "Accept",
"value": "application\/json"
}
],
"body": null,
"description": ""
},
"response": [
{
"header": [],
"code": 204,
"body": "{}",
"name": ""
}
]
}
]
},
{
"name": "Data",
"description": "",
"item": [
{
"name": "Show Data",
"request": {
"url": {
"host": "{{baseUrl}}",
"path": "api\/v1\/parts\/:part_id\/data",
"query": [
{
"key": "page",
"value": "",
"description": "Chose the number of the page. Default 1.",
"disabled": true
},
{
"key": "limit",
"value": "",
"description": "Chose the number of records to return per page (max 1000). Default 1000.",
"disabled": true
}
],
"raw": "{{baseUrl}}\/api\/v1\/parts\/:part_id\/data?page=&limit=",
"variable": [
{
"id": "part_id",
"key": "part_id",
"value": "1",
"description": "The ID of the Dataset Part."
}
]
},
"method": "GET",
"header": [
{
"key": "Content-Type",
"value": "application\/json"
},
{
"key": "Accept",
"value": "application\/json"
}
],
"body": null,
"description": "Display a listing of all data related to this Dataset Part. Is paginated.."
},
"response": [
{
"header": [],
"code": 200,
"body": "{\n \"records\": [\n {\n \"id\": [\n \"ISO 3166-1\"\n ],\n \"timestamp\": \"2020\",\n \"data\": [\n {\n \"descriptors\": \"iso-3166-numeric-country-code\",\n \"value\": \"10\",\n \"origin\": null,\n \"unit\": null,\n },\n {\n \"descriptors\": \"iso-3166-country-name-short\",\n \"value\": \"ANTARCTICA\",\n \"origin\": null,\n \"unit\": null,\n },\n ...\n ]\n },\n ...\n ]\n}",
"name": ""
}
]
},
{
"name": "Delete all Data",
"request": {
"url": {
"host": "{{baseUrl}}",
"path": "api\/v1\/parts\/:part_id\/data",
"query": [],
"raw": "{{baseUrl}}\/api\/v1\/parts\/:part_id\/data",
"variable": [
{
"id": "part_id",
"key": "part_id",
"value": "1",
"description": "The ID of the Dataset Part."
}
]
},
"method": "DELETE",
"header": [
{
"key": "Content-Type",
"value": "application\/json"
},
{
"key": "Accept",
"value": "application\/json"
}
],
"body": null,
"description": "Removes all data related to this Dataset Part."
},
"response": [
{
"header": [],
"code": 204,
"body": "{}",
"name": ""
}
]
}
]
}
],
"auth": {
"type": "bearer",
"bearer": [
{
"key": "Authorization",
"type": "string"
}
]
}
}