MENU navbar-image

Introduction

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.
Bees 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.
Different 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.
The 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.
The 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.
This 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.

This documentation aims to provide all the information you need to work with our API.

Authenticating requests

To authenticate requests, include an Authorization header with the value "Bearer {YOUR_AUTH_KEY}".

All authenticated endpoints are marked with a requires authentication badge in the documentation below.

You can retrieve your token by visiting your dashboard and clicking API Tokens.

Entities

This route will allow modifications to the meta-data for the Entities. It includes basic information like name, description and contact information. It directly “owns” datasets. It is identified by UID which is created during the data entity creation procedure.

Show Entities

requires authentication

Display a listing of Entities, the User has access to.

Example request:
curl --request GET \
    --get "https://pollinator-hub/api/v1/entities?team=1" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$response = $client->get(
    'https://pollinator-hub/api/v1/entities',
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'query' => [
            'team' => '1',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://pollinator-hub/api/v1/entities"
);

const params = {
    "team": "1",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
import requests
import json

url = 'https://pollinator-hub/api/v1/entities'
params = {
  'team': '1',
}
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()

Example response (200):


{
 "data": [
     {
         "name": "EU Pollinator Hub",
         "slug": "euph",
         "uid": "euph",
         "contact": [
             {
                 "type": "url",
                 "value": "https://pollinatorhub.eu"
             },
             {
                 "type": "email",
                 "value": "hello@pollinatorhub.eu"
             }
         ],
         "abbreviation": "EUPH",
         "registry_number": "N/A",
         "description": "The EU Pollinator Hub is a data hub related to pollinators, which is provided by the European Food Safety Authority (EFSA).",
         "address": "N/A",
         "country": {
             "iso-3166-country-name": "the Kingdom of Belgium",
             "iso-3166-numeric-country-code": "56",
             "iso-3166-country-name-short-lc": "Belgium",
             "iso-3166-alpha-2-country": "BE",
             "iso-3166-alpha-3-country": "BEL"
         },
         "public": true,
         "team_id": 1,
         "created_at": "2023-07-04T11:24:58.000000Z",
         "updated_at": "2023-07-04T11:25:00.000000Z"
     },
}
 

Example response (400, Bad Request):



 

Example response (401, Unauthorized):



 

Example response (403, Forbidden):



 

Example response (500, Internal server error):



 

Request   

GET api/v1/entities

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

Query Parameters

team   string  optional  

Filter datasets by Team. Example: 1

Response

Response Fields

data   string[]   

A list of entities available to the User.

*   object   
name   string   

A descriptive name of the entity.

slug   string   

The URL used to access the entity

uid   string   

The unique identifier used to identify the entity within the platform.

contact   object[]   

A list of contact points for the entity.

type   string   

The type of the contact.

value   string   

The actual value of the contact, for example email address, url or other.

abbreviation   string   

Abbreviation or short name of the entity.

registry_number   string   

A public unique identifier used to identify a legal entity. Can be empty for private persons.

description   string   

A longer description about the entity. Uses Markdown for styling.

address   string   

Full address of the entity. Can be empty for private persons.

country   object   

Country the entity resides in.

iso-3166-country-name   string   

Full name of the country.

iso-3166-country-name-short-lc   string   

Short name, written in lower case letters, of the country.

iso-3166-numeric-country-code   string   

Numeric code of the country according to ISO-3166 standard.

iso-3166-alpha-2-country   string   

A two-letter code that represents a country name, recommended as general purpose code.

iso-3166-alpha-3-country   string   

A three-letter code that represents a country name.

public   boolean   

1 means that the data of this entity are public.

team   integer   

Numeric identifier of a team.

created_at   string   

The date and time the entity was created.

updated_at   string   

The date and time the entity was last updated.

Create Entity

requires authentication

Store an Entity in storage.

Example request:
curl --request POST \
    "https://pollinator-hub/api/v1/entities" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"name\": \"European Food Safety Authority\",
    \"abbreviation\": \"EFSA\",
    \"description\": \"No-example\",
    \"public\": true,
    \"team_id\": 0,
    \"country_id\": \"IT\"
}"
$client = new \GuzzleHttp\Client();
$response = $client->post(
    'https://pollinator-hub/api/v1/entities',
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'name' => 'European Food Safety Authority',
            'abbreviation' => 'EFSA',
            'description' => 'No-example',
            'public' => true,
            'team_id' => 0,
            'country_id' => 'IT',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://pollinator-hub/api/v1/entities"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "name": "European Food Safety Authority",
    "abbreviation": "EFSA",
    "description": "No-example",
    "public": true,
    "team_id": 0,
    "country_id": "IT"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());
import requests
import json

url = 'https://pollinator-hub/api/v1/entities'
payload = {
    "name": "European Food Safety Authority",
    "abbreviation": "EFSA",
    "description": "No-example",
    "public": true,
    "team_id": 0,
    "country_id": "IT"
}
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('POST', url, headers=headers, json=payload)
response.json()

Request   

POST api/v1/entities

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

Body Parameters

name   string   

A descriptive name of the entity. Must not be greater than 250 characters. Must be at least 8 characters. Example: European Food Safety Authority

abbreviation   string   

Abbreviation or short name of the entity. Must not be greater than 50 characters. Must be at least 3 characters. Example: EFSA

address   string  optional  

Full address of the entity. It is not required for private persons. This field is required unless registry_number is in null. Must not be greater than 15000000 characters. Must be at least 10 characters.

registry_number   string  optional  

A public unique identifier used to identify a legal entity. Can be empty for private persons. Must not be greater than 20 characters. Must be at least 5 characters.

description   string   

A longer description about the entity. Accepts Markdown for styling. Must not be greater than 16777215 characters. Must be at least 10 characters. Example: No-example

public   boolean   

1 means that the data of this entity are public. Example: true

team_id   integer   

Numeric identifier of a team. Example: 0

country_id   string   

A two-letter code that represents a country name, recommended as general purpose code. Must be one of AQ, BG, MM, BI, BY, KH, DZ, CM, CA, CV, KY, CF, LK, TD, CL, CN, TW, AS, CX, CC, CO, KM, YT, CG, CD, CK, CR, HR, CU, CY, AD, CZ, BJ, DK, DM, DO, EC, SV, GQ, ET, ER, EE, FO, FK, GS, AO, FJ, FI, AX, FR, GF, PF, TF, DJ, GA, GE, GM, PS, DE, AG, GH, GI, KI, GR, GL, GD, AZ, GP, GU, AR, GT, GN, GY, HT, HM, VA, HN, HK, HU, IS, IN, AU, ID, IR, IQ, IE, IL, IT, CI, JM, JP, KZ, AF, AT, JO, KE, KP, KR, KW, KG, LA, LB, LS, LV, LR, LY, LI, BS, LT, LU, MO, MG, MW, MY, MV, ML, MT, MQ, MR, BH, MU, MX, MC, MN, MD, ME, BD, MS, MA, MZ, AM, OM, NA, BB, NR, NP, NL, CW, AW, SX, BQ, NC, VU, NZ, NI, BE, NE, NG, NU, NF, NO, MP, UM, FM, MH, PW, PK, PA, PG, BM, PY, PE, PH, PN, PL, PT, GW, TL, PR, QA, RE, BT, RO, RU, RW, BL, SH, KN, AI, LC, MF, PM, VC, SM, ST, BO, SA, SN, RS, SC, SL, BA, SG, SK, VN, SI, SO, ZA, ZW, BW, ES, SS, SD, EH, BV, SR, SJ, SZ, SE, CH, BR, SY, TJ, TH, TG, TK, TO, TT, AE, TN, TR, TM, TC, TV, AL, UG, UA, MK, EG, GB, GG, JE, IM, TZ, BZ, US, VI, BF, UY, IO, UZ, VE, WF, WS, YE, ZM, SB, VG, BN, BQ, BY, CT, CS, DY, NQ, AI, FQ, DD, GE, JT, MI, NH, PC, PZ, SK, RH, PU, HV, VD, WK, YD, AN, BU, CS, NT, TP, YU, ZR, AC, CP, CQ, DG, EA, EU, EZ, FX, IC, SU, TA, UK, or UN Must be 2 characters. Example: IT

contact   object  optional  

A list of contact points for the entity.

Show Entity

requires authentication

Display the specified Entity.

Example request:
curl --request GET \
    --get "https://pollinator-hub/api/v1/entities/euph" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$response = $client->get(
    'https://pollinator-hub/api/v1/entities/euph',
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://pollinator-hub/api/v1/entities/euph"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
import requests
import json

url = 'https://pollinator-hub/api/v1/entities/euph'
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers)
response.json()

Example response (401):

Show headers
cache-control: no-cache, private
content-type: application/json
phpdebugbar-id: Xebfb2854a2ac958c245274025022aa79
access-control-allow-origin: *
 

{
    "message": "Unauthenticated."
}
 

Request   

GET api/v1/entities/{uid}

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

uid   string   

The unique identifier used to identify the Entity within the platform. Example: euph

Response

Response Fields

data   object   
name   string   

A descriptive name of the entity.

slug   string   

The URL used to access the entity

uid   string   

The unique identifier used to identify the Entity within the platform.

contact   object[]   

A list of contact points for the entity.

type   string   

The type of the contact.

value   string   

The actual value of the contact, for example email address, url or other.

abbreviation   string   

Abbreviation or short name of the entity.

registry_number   string   

A public unique identifier used to identify a legal entity. Can be empty for private persons.

description   string   

A longer description about the entity. Uses Markdown for styling.

address   string   

Full address of the entity. Can be empty for private persons.

country   object   

Country the entity resides in.

iso-3166-country-name   string   

Full name of the country.

iso-3166-country-name-short-lc   string   

Short name, written in lower case letters, of the country.

iso-3166-numeric-country-code   string   

Numeric code of the country according to ISO-3166 standard.

iso-3166-alpha-2-country   string   

A two-letter code that represents a country name, recommended as general purpose code.

iso-3166-alpha-3-country   string   

A three-letter code that represents a country name.

public   boolean   

1 means that the data of this entity are public.

team   integer   

Numeric identifier of a team.

created_at   string   

The date and time the entity was created.

updated_at   string   

The date and time the entity was last updated.

Update Entity

requires authentication

Update the specified Entity in storage.

Example request:
curl --request PUT \
    "https://pollinator-hub/api/v1/entities/euph" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"name\": \"European Food Safety Authority\",
    \"abbreviation\": \"EFSA\",
    \"description\": \"No-example\",
    \"public\": true,
    \"team_id\": 0,
    \"country_id\": \"IT\"
}"
$client = new \GuzzleHttp\Client();
$response = $client->put(
    'https://pollinator-hub/api/v1/entities/euph',
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'name' => 'European Food Safety Authority',
            'abbreviation' => 'EFSA',
            'description' => 'No-example',
            'public' => true,
            'team_id' => 0,
            'country_id' => 'IT',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://pollinator-hub/api/v1/entities/euph"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "name": "European Food Safety Authority",
    "abbreviation": "EFSA",
    "description": "No-example",
    "public": true,
    "team_id": 0,
    "country_id": "IT"
};

fetch(url, {
    method: "PUT",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());
import requests
import json

url = 'https://pollinator-hub/api/v1/entities/euph'
payload = {
    "name": "European Food Safety Authority",
    "abbreviation": "EFSA",
    "description": "No-example",
    "public": true,
    "team_id": 0,
    "country_id": "IT"
}
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('PUT', url, headers=headers, json=payload)
response.json()

Request   

PUT api/v1/entities/{uid}

PATCH api/v1/entities/{uid}

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

uid   string   

The unique identifier used to identify the Entity within the platform. Example: euph

Body Parameters

name   string   

A descriptive name of the entity. Must not be greater than 250 characters. Must be at least 8 characters. Example: European Food Safety Authority

abbreviation   string   

Abbreviation or short name of the entity. Must not be greater than 50 characters. Must be at least 3 characters. Example: EFSA

address   string  optional  

Full address of the entity. It is not required for private persons. This field is required unless registry_number is in null. Must not be greater than 16777215 characters. Must be at least 10 characters.

registry_number   string  optional  

A public unique identifier used to identify a legal entity. Can be empty for private persons. Must not be greater than 20 characters. Must be at least 5 characters.

description   string   

A longer description about the entity. Accepts Markdown for styling. Must not be greater than 15000000 characters. Must be at least 10 characters. Example: No-example

public   boolean   

1 means that the data of this entity are public. Example: true

team_id   integer   

Numeric identifier of a team. Example: 0

country_id   string   

A two-letter code that represents a country name, recommended as general purpose code. Must be one of AQ, BG, MM, BI, BY, KH, DZ, CM, CA, CV, KY, CF, LK, TD, CL, CN, TW, AS, CX, CC, CO, KM, YT, CG, CD, CK, CR, HR, CU, CY, AD, CZ, BJ, DK, DM, DO, EC, SV, GQ, ET, ER, EE, FO, FK, GS, AO, FJ, FI, AX, FR, GF, PF, TF, DJ, GA, GE, GM, PS, DE, AG, GH, GI, KI, GR, GL, GD, AZ, GP, GU, AR, GT, GN, GY, HT, HM, VA, HN, HK, HU, IS, IN, AU, ID, IR, IQ, IE, IL, IT, CI, JM, JP, KZ, AF, AT, JO, KE, KP, KR, KW, KG, LA, LB, LS, LV, LR, LY, LI, BS, LT, LU, MO, MG, MW, MY, MV, ML, MT, MQ, MR, BH, MU, MX, MC, MN, MD, ME, BD, MS, MA, MZ, AM, OM, NA, BB, NR, NP, NL, CW, AW, SX, BQ, NC, VU, NZ, NI, BE, NE, NG, NU, NF, NO, MP, UM, FM, MH, PW, PK, PA, PG, BM, PY, PE, PH, PN, PL, PT, GW, TL, PR, QA, RE, BT, RO, RU, RW, BL, SH, KN, AI, LC, MF, PM, VC, SM, ST, BO, SA, SN, RS, SC, SL, BA, SG, SK, VN, SI, SO, ZA, ZW, BW, ES, SS, SD, EH, BV, SR, SJ, SZ, SE, CH, BR, SY, TJ, TH, TG, TK, TO, TT, AE, TN, TR, TM, TC, TV, AL, UG, UA, MK, EG, GB, GG, JE, IM, TZ, BZ, US, VI, BF, UY, IO, UZ, VE, WF, WS, YE, ZM, SB, VG, BN, BQ, BY, CT, CS, DY, NQ, AI, FQ, DD, GE, JT, MI, NH, PC, PZ, SK, RH, PU, HV, VD, WK, YD, AN, BU, CS, NT, TP, YU, ZR, AC, CP, CQ, DG, EA, EU, EZ, FX, IC, SU, TA, UK, or UN Must be 2 characters. Example: IT

contact   string[]  optional  

A list of contact points for the entity.

type   string   

The type of the contact. Should be one of: email, url, phone, address, url-facebook, url-twitter, url-linkedin, url-youtube, url-vimeo. Example: email

value   string   

The actual value of the contact, for example email address, url or other. Example: example@pollinatorhub.eu

Delete Entity

requires authentication

Remove the specified Entity from storage.

Example request:
curl --request DELETE \
    "https://pollinator-hub/api/v1/entities/euph" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$response = $client->delete(
    'https://pollinator-hub/api/v1/entities/euph',
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://pollinator-hub/api/v1/entities/euph"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "DELETE",
    headers,
}).then(response => response.json());
import requests
import json

url = 'https://pollinator-hub/api/v1/entities/euph'
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('DELETE', url, headers=headers)
response.json()

Request   

DELETE api/v1/entities/{uid}

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

uid   string   

The unique identifier used to identify the Entity within the platform. Example: euph

Datasets

This route will allow modifications to the meta-data for the Datasets. It includes basic information like name, description and contact information. It is owned by one or more entities. It directly owns one or more Dataset Parts. It is identified by UID which is created during the data entity creation procedure.

Show Datasets

requires authentication

Display a listing of the Datasets, the User has access to..

Example request:
curl --request GET \
    --get "https://pollinator-hub/api/v1/datasets?team=1&entity=euph" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$response = $client->get(
    'https://pollinator-hub/api/v1/datasets',
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'query' => [
            'team' => '1',
            'entity' => 'euph',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://pollinator-hub/api/v1/datasets"
);

const params = {
    "team": "1",
    "entity": "euph",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
import requests
import json

url = 'https://pollinator-hub/api/v1/datasets'
params = {
  'team': '1',
  'entity': 'euph',
}
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()

Example response (200):


{
 "data": [
      {
          "entities": [
              "euph"
          ],
          "name": "EUPH Reference dataset containing licences",
          "long_name": "EUPH Reference dataset containing licences",
          "number": "000026",
          "slug": "licences",
          "uid": "licences",
          "description": "The dataset contains all licences for data hosted on the EUPH.",
          "status": "publish",
          "public": true,
          "licence": "cc-by",
          "published_at": null
      },
 ]
}
 

Example response (400, Bad Request):



 

Example response (401, Unauthorized):



 

Example response (403, Forbidden):



 

Example response (500, Internal server error):



 

Request   

GET api/v1/datasets

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

Query Parameters

team   string  optional  

Filter datasets by Team. Example: 1

entity   string  optional  

Filter datasets by Entity uid. Example: euph

Response

Response Fields

data   object[]   

A list of Datasets available to the User.example email address, url or other.

*   object   
name   string   

The actual name of the dataset.

long_name   string   

The long version of the name of the dataset.

number   string   

Number to identify the dataset. The number will be automatically generated when the dataset is created.

slug   string   

The URL used to access the entity

uid   string   

The unique identifier used to identify the entity within the platform.

description   string   

Longer description about the dataset. Uses Markdown for styling.

entities   string[]   

Array containing the uid of the entities of this dataset.

*   string   

The Uid of the entity

contact   object[]   

A list of contact points for the entity.

type   string   

The type of the contact.

value   string   

The actual value of the contact, for

status   string   

The status of the dataset. The list of available status are the following: draft, pending, future, private, publish, trash, reject

public   boolean   

1 means that the data of this dataset are public.

licence   string|null   

The uid of the licence of this entity.

published_at   string|null   

The date and time the dataset was published.

created_at   string   

The date and time the dataset was created.

updated_at   string   

The date and time the dataset was last updated.

Create Dataset

requires authentication

Store a Dataset in storage.

Example request:
curl --request POST \
    "https://pollinator-hub/api/v1/datasets" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"entities\": [
        \"euph\"
    ],
    \"name\": \"ISO 3166-1:2020\",
    \"long_name\": \"gkuwfimodjjxccneto\",
    \"description\": \"Tempore repudiandae molestiae nam molestias laborum.\",
    \"status\": \"pending\",
    \"public\": true,
    \"licence\": \"cc-by\",
    \"published_at\": \"2023-07-04T11:24:58.000000Z\"
}"
$client = new \GuzzleHttp\Client();
$response = $client->post(
    'https://pollinator-hub/api/v1/datasets',
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'entities' => [
                'euph',
            ],
            'name' => 'ISO 3166-1:2020',
            'long_name' => 'gkuwfimodjjxccneto',
            'description' => 'Tempore repudiandae molestiae nam molestias laborum.',
            'status' => 'pending',
            'public' => true,
            'licence' => 'cc-by',
            'published_at' => '2023-07-04T11:24:58.000000Z',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://pollinator-hub/api/v1/datasets"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "entities": [
        "euph"
    ],
    "name": "ISO 3166-1:2020",
    "long_name": "gkuwfimodjjxccneto",
    "description": "Tempore repudiandae molestiae nam molestias laborum.",
    "status": "pending",
    "public": true,
    "licence": "cc-by",
    "published_at": "2023-07-04T11:24:58.000000Z"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());
import requests
import json

url = 'https://pollinator-hub/api/v1/datasets'
payload = {
    "entities": [
        "euph"
    ],
    "name": "ISO 3166-1:2020",
    "long_name": "gkuwfimodjjxccneto",
    "description": "Tempore repudiandae molestiae nam molestias laborum.",
    "status": "pending",
    "public": true,
    "licence": "cc-by",
    "published_at": "2023-07-04T11:24:58.000000Z"
}
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('POST', url, headers=headers, json=payload)
response.json()

Request   

POST api/v1/datasets

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

Body Parameters

entities   string[]   

The UID of of an related Entity.

name   string   

The name of the Dataset Part. Must not be greater than 100 characters. Must be at least 3 characters. Example: ISO 3166-1:2020

long_name   string   

The long version of the name of the dataset. Must not be greater than 256 characters. Must be at least 8 characters. Example: gkuwfimodjjxccneto

description   string   

A longer description about the Dataset Part. Accepts Markdown for styling. Must not be greater than 15000000 characters. Must be at least 10 characters. Example: Tempore repudiandae molestiae nam molestias laborum.

status   string   

The status of the dataset. Must be one of draft or pending. Example: pending

public   boolean   

Setting this Dataset Part public attribute to true will make accessible to the public while setting it to false will make it only be used for processing. Example: true

licence   string   

The UID of the licence of this entity. Must be one of cc-by, cc-by-sa, cc-by-nd, cc-by-nc, cc-by-nc-sa, cc-by-nc-nd, or cc0. Example: cc-by

published_at   string   

The date this Dataset Part can be published on the platform. A null value is allowed, having no or unknown publishing date. Must be a valid date. Example: 2023-07-04T11:24:58.000000Z

Show Dataset

requires authentication

Display the specified Dataset.

Example request:
curl --request GET \
    --get "https://pollinator-hub/api/v1/datasets/countries" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$response = $client->get(
    'https://pollinator-hub/api/v1/datasets/countries',
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://pollinator-hub/api/v1/datasets/countries"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
import requests
import json

url = 'https://pollinator-hub/api/v1/datasets/countries'
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers)
response.json()

Example response (401):

Show headers
cache-control: no-cache, private
content-type: application/json
phpdebugbar-id: Xebfb2854a2ac958c245274025022aa79
access-control-allow-origin: *
 

{
    "message": "Unauthenticated."
}
 

Request   

GET api/v1/datasets/{uid}

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

uid   string   

The unique identifier used to identify the Dataset within the platform. Example: countries

Response

Response Fields

data   object   
name   string   

The actual name of the dataset.

long_name   string   

The long version of the name of the dataset.

number   string   

Number to identify the dataset. The number will be automatically generated when the dataset is created.

slug   string   

The URL used to access the entity

uid   string   

The unique identifier used to identify the entity within the platform.

description   string   

Longer description about the dataset. Uses Markdown for styling.

entities   string[]   

Array containing the uid of the entities of this dataset.

*   string   

The Uid of the entity

contact   object[]   

A list of contact points for the entity.

type   string   

The type of the contact.

value   string   

The actual value of the contact, for example email address, url or other.

status   string   

The status of the dataset. The list of available status are the following: draft, pending, future, private, publish, trash, reject

public   boolean   

1 means that the data of this dataset are public.

licence   string|null   

The uid of the licence of this entity.

published_at   string|null   

The date and time the dataset was published.

created_at   string   

The date and time the dataset was created.

updated_at   string   

The date and time the dataset was last updated.

Update Dataset

requires authentication

Update the specified Dataset in storage.

Example request:
curl --request PUT \
    "https://pollinator-hub/api/v1/datasets/countries" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"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\"
}"
$client = new \GuzzleHttp\Client();
$response = $client->put(
    'https://pollinator-hub/api/v1/datasets/countries',
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            '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',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://pollinator-hub/api/v1/datasets/countries"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "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"
};

fetch(url, {
    method: "PUT",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());
import requests
import json

url = 'https://pollinator-hub/api/v1/datasets/countries'
payload = {
    "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"
}
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('PUT', url, headers=headers, json=payload)
response.json()

Request   

PUT api/v1/datasets/{uid}

PATCH api/v1/datasets/{uid}

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

uid   string   

The unique identifier used to identify the Dataset within the platform. Example: countries

Body Parameters

entities   string[]   

The UID of of an related Entity.

name   string   

The name of the Dataset Part. Must not be greater than 100 characters. Must be at least 3 characters. Example: ISO 3166-1:2020

long_name   string   

The long version of the name of the dataset. Must not be greater than 256 characters. Must be at least 8 characters. Example: No-example

description   string   

A longer description about the Dataset Part. Accepts Markdown for styling. Must not be greater than 15000000 characters. Must be at least 10 characters. Example: No-example

status   string   

The status of the dataset. Must be one of draft or pending. Example: pending

licence   string   

The UID of the licence of this entity. Must be one of cc-by, cc-by-sa, cc-by-nd, cc-by-nc, cc-by-nc-sa, cc-by-nc-nd, or cc0. Example: cc-by

public   boolean   

Setting this Dataset Part public attribute to true will make accessible to the public while setting it to false will make it only be used for processing. Example: true

published_at   string   

The date this Dataset Part can be published on the platform. A null value is allowed, having no or unknown publishing date. Must be a valid date. Example: 2023-07-04T11:24:58.000000Z

Delete Dataset

requires authentication

Remove the specified Dataset from storage.

Example request:
curl --request DELETE \
    "https://pollinator-hub/api/v1/datasets/countries" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$response = $client->delete(
    'https://pollinator-hub/api/v1/datasets/countries',
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://pollinator-hub/api/v1/datasets/countries"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "DELETE",
    headers,
}).then(response => response.json());
import requests
import json

url = 'https://pollinator-hub/api/v1/datasets/countries'
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('DELETE', url, headers=headers)
response.json()

Request   

DELETE api/v1/datasets/{uid}

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

uid   string   

The unique identifier used to identify the Dataset within the platform. Example: countries

Dataset Parts

Show Dataset Parts

requires authentication

Display a listing of Dataset Parts, the User has access to.

Example request:
curl --request GET \
    --get "https://pollinator-hub/api/v1/datasets//parts" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$response = $client->get(
    'https://pollinator-hub/api/v1/datasets//parts',
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://pollinator-hub/api/v1/datasets//parts"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
import requests
import json

url = 'https://pollinator-hub/api/v1/datasets//parts'
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers)
response.json()

Example response (200):


{
    "data": [
        {
            "name": "ISO 3166-1:2020",
            "description": "File iso3166_1_2020.csv contains 291 records of countries included in the ISO standard 3166-1:2020...",
            "status": "publish",
            "public": true,
            "type": "file",
            "entities": [],
            "licence_id": "unlicenced",
            "dataset_uid": "countries",
            "published_at": "2022-11-14T00:00:00.000000Z",
            "created_at": "2023-07-04T11:24:58.000000Z",
            "updated_at": "2023-07-04T11:24:58.000000Z"
        }
    ]
}
 

Request   

GET api/v1/datasets/{dataset_uid}/parts

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

dataset_uid   string   

The UID of the dataset to display related parts of.

Create Dataset Part.

requires authentication

Store a Dataset Part in storage.

Example request:
curl --request POST \
    "https://pollinator-hub/api/v1/datasets/euph/parts" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"name\": \"ISO 3166-1:2020\",
    \"description\": \"No-example\",
    \"entities\": [
        \"euph\"
    ],
    \"status\": \"pending\",
    \"type\": \"api\",
    \"public\": true,
    \"published_at\": \"2023-07-04T11:24:58.000000Z\"
}"
$client = new \GuzzleHttp\Client();
$response = $client->post(
    'https://pollinator-hub/api/v1/datasets/euph/parts',
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'name' => 'ISO 3166-1:2020',
            'description' => 'No-example',
            'entities' => [
                'euph',
            ],
            'status' => 'pending',
            'type' => 'api',
            'public' => true,
            'published_at' => '2023-07-04T11:24:58.000000Z',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://pollinator-hub/api/v1/datasets/euph/parts"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "name": "ISO 3166-1:2020",
    "description": "No-example",
    "entities": [
        "euph"
    ],
    "status": "pending",
    "type": "api",
    "public": true,
    "published_at": "2023-07-04T11:24:58.000000Z"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());
import requests
import json

url = 'https://pollinator-hub/api/v1/datasets/euph/parts'
payload = {
    "name": "ISO 3166-1:2020",
    "description": "No-example",
    "entities": [
        "euph"
    ],
    "status": "pending",
    "type": "api",
    "public": true,
    "published_at": "2023-07-04T11:24:58.000000Z"
}
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('POST', url, headers=headers, json=payload)
response.json()

Request   

POST api/v1/datasets/{dataset_uid}/parts

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

dataset_uid   string   

Example: euph

Body Parameters

name   string   

The name of the Dataset Part. Must not be greater than 150 characters. Must be at least 8 characters. Example: ISO 3166-1:2020

description   string   

A longer description about the Dataset Part. Accepts Markdown for styling. Must not be greater than 15000000 characters. Must be at least 10 characters. Example: No-example

entities   string[]  optional  

The UID of of an related Entity.

status   string   

The status of the dataset. The list of available statuses are: draft, pending. Must be one of draft or pending. Example: pending

type   string   

The type this Dataset Part represents. Use 'api' when uploading data via the API. The list of available types are: file ,remote ,api. Must be one of file, remote, or api. Example: api

public   boolean   

Setting this Dataset Part public attribute to true will make accessible to the public while setting it to false will make it only be used for processing. Example: true

published_at   string   

The date this Dataset Part can be published on the platform. Must be a valid date. Example: 2023-07-04T11:24:58.000000Z

Display the specified resource.

requires authentication

Example request:
curl --request GET \
    --get "https://pollinator-hub/api/v1/parts/1" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$response = $client->get(
    'https://pollinator-hub/api/v1/parts/1',
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://pollinator-hub/api/v1/parts/1"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
import requests
import json

url = 'https://pollinator-hub/api/v1/parts/1'
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers)
response.json()

Example response (401):

Show headers
cache-control: no-cache, private
content-type: application/json
phpdebugbar-id: Xebfb2854a2ac958c245274025022aa79
access-control-allow-origin: *
 

{
    "message": "Unauthenticated."
}
 

Request   

GET api/v1/parts/{id}

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

id   integer   

The numeric identifier used to identify the Dataset Part within the platform. Example: 1

Update the specified resource in storage.

requires authentication

Example request:
curl --request PUT \
    "https://pollinator-hub/api/v1/parts/1" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"entities\": [
        \"euph\"
    ],
    \"name\": \"ISO 3166-1:2020\",
    \"description\": \"No-example\",
    \"status\": \"pending\",
    \"type\": \"api\",
    \"public\": true,
    \"published_at\": \"2023-07-04T11:24:58.000000Z\"
}"
$client = new \GuzzleHttp\Client();
$response = $client->put(
    'https://pollinator-hub/api/v1/parts/1',
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'entities' => [
                'euph',
            ],
            'name' => 'ISO 3166-1:2020',
            'description' => 'No-example',
            'status' => 'pending',
            'type' => 'api',
            'public' => true,
            'published_at' => '2023-07-04T11:24:58.000000Z',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://pollinator-hub/api/v1/parts/1"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "entities": [
        "euph"
    ],
    "name": "ISO 3166-1:2020",
    "description": "No-example",
    "status": "pending",
    "type": "api",
    "public": true,
    "published_at": "2023-07-04T11:24:58.000000Z"
};

fetch(url, {
    method: "PUT",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());
import requests
import json

url = 'https://pollinator-hub/api/v1/parts/1'
payload = {
    "entities": [
        "euph"
    ],
    "name": "ISO 3166-1:2020",
    "description": "No-example",
    "status": "pending",
    "type": "api",
    "public": true,
    "published_at": "2023-07-04T11:24:58.000000Z"
}
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('PUT', url, headers=headers, json=payload)
response.json()

Request   

PUT api/v1/parts/{id}

PATCH api/v1/parts/{id}

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

id   integer   

The numeric identifier used to identify the Dataset Part within the platform. Example: 1

Body Parameters

entities   string[]  optional  

The UID of of an related Entity.

name   string   

The name of the Dataset Part. Must not be greater than 150 characters. Must be at least 3 characters. Example: ISO 3166-1:2020

description   string   

A longer description about the Dataset Part. Accepts Markdown for styling. Must not be greater than 15000000 characters. Must be at least 10 characters. Example: No-example

status   string   

The status of the dataset. The list of available statuses are: draft, pending. Must be one of draft or pending. Example: pending

type   string   

The type this Dataset Part represents. Use 'api' when uploading data via the API. The list of available types are: file ,remote ,api. Must be one of file, remote, or api. Example: api

public   boolean   

Setting this Dataset Part public attribute to true will make accessible to the public while setting it to false will make it only be used for processing. Example: true

published_at   string   

The date this Dataset Part can be published on the platform. A null value is allowed, having no or unknown publishing date. Must be a valid date. Example: 2023-07-04T11:24:58.000000Z

Remove the specified resource from storage.

requires authentication

Example request:
curl --request DELETE \
    "https://pollinator-hub/api/v1/parts/1" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$response = $client->delete(
    'https://pollinator-hub/api/v1/parts/1',
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://pollinator-hub/api/v1/parts/1"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "DELETE",
    headers,
}).then(response => response.json());
import requests
import json

url = 'https://pollinator-hub/api/v1/parts/1'
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('DELETE', url, headers=headers)
response.json()

Request   

DELETE api/v1/parts/{id}

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

id   integer   

The numeric identifier used to identify the Dataset Part within the platform. Example: 1

Data

Show Data

requires authentication

Display a listing of all data related to this Dataset Part. Is paginated..

Example request:
curl --request GET \
    --get "https://pollinator-hub/api/v1/parts/1/data" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$response = $client->get(
    'https://pollinator-hub/api/v1/parts/1/data',
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://pollinator-hub/api/v1/parts/1/data"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
import requests
import json

url = 'https://pollinator-hub/api/v1/parts/1/data'
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers)
response.json()

Example response (200):


{
     "records": [
         {
             "id": [
                   "ISO 3166-1"
             ],
             "timestamp": "2020",
             "data": [
                 {
                     "descriptors": "iso-3166-numeric-country-code",
                     "value": "10",
                     "origin": null,
                     "unit": null,
                 },
                 {
                     "descriptors": "iso-3166-country-name-short",
                     "value": "ANTARCTICA",
                     "origin": null,
                     "unit": null,
                 },
                 ...
             ]
         },
         ...
     ]
}
 

Request   

GET api/v1/parts/{part_id}/data

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

part_id   integer   

The ID of the Dataset Part. Example: 1

Query Parameters

page   integer  optional  

Chose the number of the page. Default 1.

limit   integer  optional  

Chose the number of records to return per page (max 1000). Default 1000.

Response

Response Fields

records   object[]   

List of Records.

*   object   
id   string[]   

List of Ids, this record is associated with.

timestamp   string   

Timestamp this record was recorded at.

data   object[]   

List of data contained within the Record.

*   object   
descriptor   string   

The UID of the descriptor this datum represents.

value      

The value of the datum.

origin      

The UID of the Origin, this datum is related to. Can be null.

unit      

The UID of the Unit, this datum is related to. Can be null.

Store Data

requires authentication

Store a set of records within provided Dataset Part.

Example request:
curl --request POST \
    "https://pollinator-hub/api/v1/parts/1/data" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"ids\": [
        \"hive-scale-15\"
    ],
    \"locations\": \"dnfhvwenkevbirxpmdkcbtrxpr\",
    \"records\": [
        \"vel\"
    ]
}"
$client = new \GuzzleHttp\Client();
$response = $client->post(
    'https://pollinator-hub/api/v1/parts/1/data',
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'ids' => [
                'hive-scale-15',
            ],
            'locations' => 'dnfhvwenkevbirxpmdkcbtrxpr',
            'records' => [
                'vel',
            ],
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://pollinator-hub/api/v1/parts/1/data"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "ids": [
        "hive-scale-15"
    ],
    "locations": "dnfhvwenkevbirxpmdkcbtrxpr",
    "records": [
        "vel"
    ]
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());
import requests
import json

url = 'https://pollinator-hub/api/v1/parts/1/data'
payload = {
    "ids": [
        "hive-scale-15"
    ],
    "locations": "dnfhvwenkevbirxpmdkcbtrxpr",
    "records": [
        "vel"
    ]
}
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('POST', url, headers=headers, json=payload)
response.json()

Request   

POST api/v1/parts/{part_id}/data

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

part_id   integer   

The ID of the Dataset Part. Example: 1

Body Parameters

ids   string[]  optional  

The UID for all data. Should be used to easier identify specific sets of data within the dataset. Must be at least 1 character.

locations   string[]  optional  

Location information that is related to uploaded data. Must have at least 1 items. Example: dnfhvwenkevbirxpmdkcbtrxpr

type   string   

The type of location, that is provided. Must be one of nuts-0, nuts-1, nuts-2, nuts-3, lau, country, post, poldist, laustat, hpg, kpg, or wgs84. Example: kpg

lat   number  optional  

Latitude coordinate of the uploaded data in decimal degrees. This field is required when locations.*.type is wgs84. This field is required when locations.lon is present. Must be at least -180. Must not be greater than 180. Example: 50.846667

lon   number  optional  

Longitude coordinate of the uploaded data in decimal degrees. This field is required when locations.*.type is wgs84. This field is required when locations.lat is present. Must be at least -90. Must not be greater than 90. Example: 4.3525

code   string  optional  

The code corresponding to the given type of the location.. This field is required unless :locations.*.type is in wgs84. Example: rerum

records   string[][]   

A list of records (rows) to be uploaded.

ids   string[]  optional  

The UID.

timestamp   string   

Time of measurement in ISO 8601 timestamp. Must be a valid date. Example: 2022-09-27 18:00:00

data   string[]   

A list of columns to insert. Must have at least 1 items. Example: qxltfaxqzepfogcevysnesjjhyaykhqtpmpmrdptnrrepqkkgpnyomhtjwlbno

descriptor   string   

UID of the column. Must be one of numeric-country-code-iso-3166, country-name, country-name-short, alpha-2-country-code-iso-3166, alpha-3-country-code-iso-3166, iso-3166-country-id, iso-3166-numeric-country-code, iso-3166-country-name, iso-3166-country-name-short, iso-3166-country-name-short-lc, iso-3166-alpha-2-country, iso-3166-alpha-3-country, iso-3166-alpha-4-country, iso-3166-start-date, iso-3166-end-date, iso-3166-status, iso-3166-annotation-status, iso-3166-annotation-1, iso-3166-annotation-2, iso-3166-annotation-3, licence-id, licences-abbreviation, licences-slug, licences-uid, licences-name, licences-description, licences-url-summary, licences-url-legal, licences-availability, created-at, updated-at, deleted-at, scale-weight, nuts_areaunits_alpha2code, nuts_areaunits_nuts1, nuts_areaunits_nuts1_latin, nuts_areaunits_nuts2, nuts_areaunits_nuts2_latin, nuts_areaunits_nuts3, nuts_areaunits_nuts3_latin, nuts_areaunits_lau, nuts_areaunits_lau_latin, nuts_border_id, nuts_border_description, nuts_coastal_id, nuts_coastal_description, nuts_mountain_id, nuts_mountain_description, nuts_remoteness_id, nuts_remoteness_description, nuts_urbanrural_id, nuts_urbanrural_description, nuts_nuts_code, nuts_nuts_name, nuts_nuts_name_latin, nuts_nuts_level, nuts_nuts_version, nuts_nuts_urbanrural, nuts_nuts_metro_log, nuts_nuts_metro_code, nuts_nuts_metro_label, nuts_nuts_coastal, nuts_nuts_mountain, nuts_nuts_border, nuts_nuts_island_log, nuts_nuts_remoteness, nuts_nuts_valid_from, nuts_nuts_valid_to, nuts_lau_id, nuts_lau_nuts, nuts_lau_code, nuts_lau_name_national, nuts_lau_name_latin, iso-4217-id, iso-4217-alpha-3-code, iso-4217-entity, iso-4217-currency, iso-4217-alphabetic-code, iso-4217-numeric-code, iso-4217-minor-unit, iso-4217-definitions, iso-4217-withdraw-range, iso-4217-date-published, units-unit-id, units-unit-name, units-unit-standardised, units-quantity-description, units-unit-description, units-base-unit, units-conv-funct, units-multiplier, units-faostat-unit, units-unsd-unit, units-si-unit, units-currency-unit, iso639_1_alpha2, iso639_1_name, iso639_1_euofficiallog, iso639_1_euprocedurallog, iso639_2_alpha3b, iso639_2_alpha3t, iso639_2_alpha2, iso639_2_name, iso639_2_name_fr, iso639_3_alpha3, iso639_3_alpha3b, iso639_3_alpha3t, iso639_3_alpha2, iso639_3_scope, iso639_3_type, iso639_3_ref_name, iso639_3_comment, iso639_3_macrolanguages_m_id, iso639_3_macrolanguages_i_id, iso639_3_macrolanguages_i_status, iso639_3_names_id, iso639_3_names_iso639_3_alpha, iso639_3_names_print_name, iso639_3_names_inverted_name, iso639_3_retirements_id, iso639_3_retirements_ref_name, iso639_3_retirements_ret_reason, iso639_3_retirements_change_to, iso639_3_retirements_ret_remedy, iso639_3_retirements_effective, poldist_poldistrictid, poldist_poldistrictcode, poldist_description, poldist_reference_column, laustat_municipalitycode, laustat_municipalityname, laustat_lau, laustat_postcode, laustat_nuts, laustat_poldistrictid, laustat_poldistrictcode, laustat_reference_column, hpg_hpg, hpg_description, hpg_reference_column, kpg_kpg, kpg_description, kpg_reference_column, laubab_municipalitycode, laubab_hpg, laubab_kpg, laubab_reference_column, honey_id, honey_year, honey_beekeeper, honey_apiary, honey_yield, honey_nuts, honey_hpg, 01_sites_coord_site_no, 01_sites_coord_site_name, 01_sites_coord_country, 02_polygons_coord_site_no, 02_polygons_coord_unique_poly_id, 02_polygons_coord_area, 02_polygons_coord_utm_coordinates_of_centroid, table_i_pesticide_application_application_id, table_i_pesticide_application_site_no, table_i_pesticide_application_field_no, table_i_pesticide_application_crop_code, table_i_pesticide_application_crop_code_desc, table_i_pesticide_application_crop_text, table_i_pesticide_application_field_area, table_i_pesticide_application_site_slope, table_i_pesticide_application_usage_y, table_i_pesticide_application_usage_m, table_i_pesticide_application_usage_d, table_i_pesticide_application_crop_stage, table_i_pesticide_application_crop_height, table_i_pesticide_application_product_name, table_i_pesticide_application_active_substance, table_i_pesticide_application_active_substance_desc, table_i_pesticide_application_application_code, table_i_pesticide_application_low_drift, table_i_pesticide_application_speed, table_i_pesticide_application_nozzle_type, table_i_pesticide_application_nnozzles, table_i_pesticide_application_nozzle_spacing, table_i_pesticide_application_nozzle_orientation, table_i_pesticide_application_droplet_size, table_i_pesticide_application_n_bar, table_i_pesticide_application_boom_height, table_i_pesticide_application_boom_width, table_i_pesticide_application_formulation, table_i_pesticide_application_volume, table_i_pesticide_application_dose_rate, table_i_pesticide_application_amount, table_i_pesticide_application_spray_round, table_i_pesticide_application_treated_area, table_i_pesticide_application_start_time, table_i_pesticide_application_hours, table_i_pesticide_application_ic_buffer, table_ii_resource_providing_unit_coord_res_id, table_ii_resource_providing_unit_coord_site_no, table_ii_resource_providing_unit_coord_field_no, table_ii_resource_providing_unit_coord_polygon_id, table_ii_resource_providing_unit_coord_uzm_Coordinates, table_ii_resource_providing_unit_coord_samp_y, table_ii_resource_providing_unit_coord_samp_m, table_ii_resource_providing_unit_coord_samp_d, table_ii_resource_providing_unit_coord_samp_mat_code, table_ii_resource_providing_unit_coord_plant_type, table_ii_resource_providing_unit_coord_vegetative_type, table_ii_resource_providing_unit_coord_flowering, table_ii_resource_providing_unit_coord_abundance_class, table_ii_resource_providing_unit_coord_pollen, table_ii_resource_providing_unit_coord_nectar, table_ii_resource_providing_unit_coord_an_met_text, table_iii_hives_hive_id, table_iii_hives_beeKeeper_id, table_iii_hives_site_no, table_iii_hives_hive_no, table_iii_hives_samp_country, table_iii_hives_utm_coordinates, table_iii_hives_hive_type, table_iii_hives_sub_species, table_iii_hives_observation_hive, table_iii_hives_colony_size, table_iv_colony_management_event_id, table_iv_colony_management_beekeeper_id, table_iv_colony_management_site_no, table_iv_colony_management_hive_no, table_iv_colony_management_event_y, table_iv_colony_management_event_m, table_iv_colony_management_event_d, table_iv_colony_management_event_type, table_iv_colony_management_inout_type, table_iv_colony_management_inout_quantity, table_iv_colony_management_inout_unit, table_iv_colony_management_inout_unit_desc, table_iv_colony_management_clinical_signs, table_iv_colony_management_event_description, table_v_colony_inspection_res_id, table_v_colony_inspection_site_no, table_v_colony_inspection_hive_no, table_v_colony_inspection_frame_fo, table_v_colony_inspection_samp_y, table_v_colony_inspection_samp_m, table_v_colony_inspection_samp_d, table_v_colony_inspection_samp_t, table_v_colony_inspection_param_text, table_v_colony_inspection_anMeth_text, table_v_colony_inspection_res_val, table_v_colony_inspection_res_unit, table_v_colony_inspection_res_unit_desc, table_v_colony_inspection_res_val_uncert, table_v_colony_inspection_res_val_uncert_sd, table_v_colony_inspection_res_qual_value, table_vi_ssd2_res_id, table_vi_ssd2_samp_unit_ids, table_vi_ssd2_samp_holding_id, table_vi_ssd2_herd_id, table_vi_ssd2_samp_id, table_vi_ssd2_samp_country, table_vi_ssd2_samp_y, table_vi_ssd2_samp_m, table_vi_ssd2_samp_d, table_vi_ssd2_samp_event_info, table_vi_ssd2_samp_size, table_vi_ssd2_samp_size_unit, table_vi_ssd2_samp_size_unit_desc, table_vi_ssd2_samp_mat_code, table_vi_ssd2_samp_mat_text, table_vi_ssd2_analysis_y, table_vi_ssd2_analysis_m, table_vi_ssd2_analysis_d, table_vi_ssd2_an_port_seq, table_vi_ssd2_lab_id, table_vi_ssd2_lab_accred, table_vi_ssd2_lab_accred_desc, table_vi_ssd2_param_code, table_vi_ssd2_param_code_desc, table_vi_ssd2_param_text, table_vi_ssd2_an_meth_ref_id, table_vi_ssd2_an_meth_code, table_vi_ssd2_an_meth_code_desc, table_vi_ssd2_an_meth_text, table_vi_ssd2_res_unit, table_vi_ssd2_res_unit_desc, table_vi_ssd2_res_lod, table_vi_ssd2_res_loq, table_vi_ssd2_res_val, table_vi_ssd2_res_val_rec, table_vi_ssd2_res_val_rec_corr, table_vi_ssd2_expr_res_type, table_vi_ssd2_expr_res_type_desc, table_vi_ssd2_res_qual_value, table_vi_ssd2_res_type, table_vi_ssd2_res_type_desc, table_vi_ssd2_res_val_uncert, table_vi_ssd2_res_val_uncert_sd, table_vii_observation_colony_observation_id, table_vii_observation_colony_dancer_id, table_vii_observation_colony_site_no, table_vii_observation_colony_hive_no, table_vii_observation_colony_samp_y, table_vii_observation_colony_samp_m, table_vii_observation_colony_samp_d, table_vii_observation_colony_samp_t, table_vii_observation_colony_waggle_dDuration, table_vii_observation_colony_waggle_lLength, table_vii_observation_colony_waggle_oOrientation, table_vii_observation_colony_waggle_direction, table_vii_observation_colony_pollen_color, or table_vii_observation_colony_pollen_abundance. Example: scale-weight

value   string   

The value of the column. Must be at least 1 character. Example: 55.23

unit   string  optional  

Optionally the name of the unit the value is provided in. By skipping this value a default is used based on the column type. Must be one of , n.a., %, % of total LSU, trillion EUR, billion EUR, million EUR, thousand EUR, EUR, EUR/kg, trillion USD, billion USD, million USD, thousand USD, USD, USD/m3, LCU, LCU/1000 kcal, LCU/J, LCU/t, LCU/kg, LCU/person/day, SLC, 1000 I$, I$, I$/person, units/100 km2 land area, units/ha land area, km, m, dm, cm, mm, μm, nm, 1000 ha, ha, m2, dm2, cm2, mm2, L, m3, 1000 head, head, no./animal, million no., thousand no., no., 1000 person, person, index, 2u, 12u, 1000u, u, U (jeu/pack), kcal/capita/day, J/capita/day, million kcal, kcal, Terajoule, 1000 kWh, kWh, joule, electronvolt, watt, °C, Varroa mites/day, km/h, m/s, m/s2, year, month, week, day, hour, minute, second, 100 mg/animal, hg/animal, mg/animal, hg/t, t/ha, hg/ha, kg/ha, kg/person, kg nutrients, g CH4/kg dry matter, kg CH4/head, g N2O/kg dry matter, kg N2O-N/ha, kg N2O-N/kg N, kg CO2eq/kg product, g/capita/day, Mt, kt, t, kg, hg, dag, g, mg, ng, carat, degree, angle minute, angle second, radian, steradian, ampere, volt, farad, ohm, siemens, mole, mole/m3, kelvin, hertz, newton, pascal, lux, becquerel, sievert, katal, kg/m3, m3/kg, candela, W/m2, cd/m2, coulomb, weber, tesla, henry, lumen, gray, /m, kg/m2, A/m2, A/m, Pa s, N m, N/m, rad/s, rad/s2, J/K, J/(K kg), J/kg, W/(K m), J/m3, V/m, C/m3, C/m2, F/m, H/m, J/mol, J/(K mol), C/kg, Gy/s, W/sr, W/(sr m2), kat/m3, astronomical unit, dalton, neper, bel, decibel, ADP, AED, AFA, AFN, ALK, ALL, AMD, ANG, AOA, AOK, AON, AOR, ARA, ARP, ARS, ARY, ATS, AUD, AWG, AYM, AZM, AZN, BAD, BAM, BBD, BDT, BEC, BEF, BEL, BGJ, BGK, BGL, BGN, BHD, BIF, BMD, BND, BOB, BOP, BOV, BRB, BRC, BRE, BRL, BRN, BRR, BSD, BTN, BUK, BWP, BYB, BYN, BYR, BZD, CAD, CDF, CHC, CHE, CHF, CHW, CLF, CLP, CNY, COP, COU, CRC, CSD, CSJ, CSK, CUC, CUP, CVE, CYP, CZK, DDM, DEM, DJF, DKK, DOP, DZD, ECS, ECV, EEK, EGP, ERN, ESA, ESB, ESP, ETB, FIM, FJD, FKP, FRF, GBP, GEK, GEL, GHC, GHP, GHS, GIP, GMD, GNE, GNF, GNS, GQE, GRD, GTQ, GWE, GWP, GYD, HKD, HNL, HRD, HRK, HTG, HUF, IDR, IEP, ILP, ILR, ILS, INR, IQD, IRR, ISJ, ISK, ITL, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAJ, LAK, LBP, LKR, LRD, LSL, LSM, LTL, LTT, LUC, LUF, LUL, LVL, LVR, LYD, MAD, MDL, MGA, MGF, MKD, MLF, MMK, MNT, MOP, MRO, MRU, MTL, MTP, MUR, MVQ, MVR, MWK, MXN, MXP, MXV, MYR, MZE, MZM, MZN, NAD, NGN, NIC, NIO, NLG, NOK, NPR, NZD, OMR, PAB, PEH, PEI, PEN, PES, PGK, PHP, PKR, PLN, PLZ, PTE, PYG, QAR, RHD, ROK, ROL, RON, RSD, RUB, RWF, SAR, SBD, SCR, SDD, SDG, SDP, SEK, SGD, SHP, SIT, SKK, SLE, SLL, SOS, SRD, SRG, SSP, STD, STN, SUR, SVC, SYP, SZL, THB, TJR, TJS, TMM, TMT, TND, TOP, TPE, TRL, TRY, TTD, TWD, TZS, UAH, UAK, UGS, UGW, UGX, USN, USS, UYI, UYN, UYP, UYU, UYW, UZS, VEB, VED, VEF, VES, VNC, VND, VUV, WST, XAF, XAG, XAU, XBA, XBB, XBC, XBD, XCD, XDR, XEU, XFO, XFU, XOF, XPD, XPF, XPT, XRE, XSU, XTS, XUA, XXX, YDD, YER, YUD, YUM, YUN, ZAL, ZAR, ZMK, ZMW, ZRN, ZRZ, ZWC, ZWD, ZWL, ZWN, or ZWR. Example: kg

Delete all Data

requires authentication

Removes all data related to this Dataset Part.

Example request:
curl --request DELETE \
    "https://pollinator-hub/api/v1/parts/iso3166_1_2020/data" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$response = $client->delete(
    'https://pollinator-hub/api/v1/parts/iso3166_1_2020/data',
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://pollinator-hub/api/v1/parts/iso3166_1_2020/data"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "DELETE",
    headers,
}).then(response => response.json());
import requests
import json

url = 'https://pollinator-hub/api/v1/parts/iso3166_1_2020/data'
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('DELETE', url, headers=headers)
response.json()

Request   

DELETE api/v1/parts/{part_uid}/data

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

part_uid   string   

Example: iso3166_1_2020

part_id   integer   

The ID of the Dataset Part. Example: 1