DAdados
datasets

Create a new dataset

Changed on
post/datasets/

Request

  • Base URL
    https://dados.gov.pt/api/1
  • URL
    https://dados.gov.pt/api/1/datasets/
  • Auth
    none declared

Headers

X-Fieldsstring mask

An optional fields mask

Request body

access_typestring
access_type_reasonstring
access_type_reason_categorystring
acronymstring

An optional dataset acronym

archivedstring date-time

The archival date if archived

authorization_request_urlstring
created_atstring date-time required

This date is computed between harvested creation date if any and site's internal creation date

deletedstring date-time

The deletion date if deleted

descriptionstring markdown required

The dataset description in markdown

description_shortstring

The dataset short description

extrasobject

Extras attributes as key-value pairs

featuredboolean

Is the dataset featured

frequency'continuous' | 'oneMinute' | 'fiveMinutes' | 'tenMinutes' | 'fifteenMinutes' | 'thirtyMinutes' | 'hourly' | 'bihourly' | 'trihourly' | 'twelveHours' | 'severalTimesADay' | 'threeTimesADay' | 'semidaily' | 'daily' | 'fiveTimesAWeek' | 'threeTimesAWeek' | 'semiweekly' | 'weekly' | 'biweekly' | 'threeTimesAMonth' | 'semimonthly' | 'monthly' | 'bimonthly' | 'quarterly' | 'threeTimesAYear' | 'semiannual' | 'annual' | 'biennial' | 'triennial' | 'quadrennial' | 'quinquennial' | 'decennial' | 'bidecennial' | 'tridecennial' | 'punctual' | 'irregular' | 'never' | 'notPlanned' | 'other' | 'unknown' required

The update frequency

frequency_datestring date-time

Next expected update date, you will be notified once that date is reached.

idstring

The dataset identifier

last_modifiedstring date-time required

The dataset last modification date

last_updatestring date-time required

The resources last modification date

licensestring

The dataset license

license_titlestring

The dataset license human-readable title

license_urlstring

The dataset license URL

metricsobject

The dataset metrics

pagestring

The dataset web page URL

privateboolean

Is the dataset private to the owner or the organization

qualityobject

The dataset quality

slugstring

The dataset permalink string

tagsstring[]
titlestring required

The dataset title

uristring

The API URI for this dataset

Example request

{
  "access_audiences": [
    {
      "condition": "yes",
      "role": "local_authority_and_administration"
    }
  ],
  "community_resources": [
    {
      "checksum": {
        "type": "sha1"
      },
      "filetype": "file",
      "type": "main"
    }
  ],
  "contact_points": [
    {
      "role": "contact"
    }
  ],
  "frequency": "continuous",
  "resources": [
    {
      "checksum": {
        "type": "sha1"
      },
      "filetype": "file",
      "type": "main"
    }
  ],
  "spatial": {
    "geom": {
      "type": "Point"
    }
  }
}

Response

Success

access_typestring
access_type_reasonstring
access_type_reason_categorystring
acronymstring

An optional dataset acronym

archivedstring date-time

The archival date if archived

authorization_request_urlstring
created_atstring date-time required

This date is computed between harvested creation date if any and site's internal creation date

deletedstring date-time

The deletion date if deleted

descriptionstring markdown required

The dataset description in markdown

description_shortstring

The dataset short description

extrasobject

Extras attributes as key-value pairs

featuredboolean

Is the dataset featured

frequency'continuous' | 'oneMinute' | 'fiveMinutes' | 'tenMinutes' | 'fifteenMinutes' | 'thirtyMinutes' | 'hourly' | 'bihourly' | 'trihourly' | 'twelveHours' | 'severalTimesADay' | 'threeTimesADay' | 'semidaily' | 'daily' | 'fiveTimesAWeek' | 'threeTimesAWeek' | 'semiweekly' | 'weekly' | 'biweekly' | 'threeTimesAMonth' | 'semimonthly' | 'monthly' | 'bimonthly' | 'quarterly' | 'threeTimesAYear' | 'semiannual' | 'annual' | 'biennial' | 'triennial' | 'quadrennial' | 'quinquennial' | 'decennial' | 'bidecennial' | 'tridecennial' | 'punctual' | 'irregular' | 'never' | 'notPlanned' | 'other' | 'unknown' required

The update frequency

frequency_datestring date-time

Next expected update date, you will be notified once that date is reached.

idstring

The dataset identifier

last_modifiedstring date-time required

The dataset last modification date

last_updatestring date-time required

The resources last modification date

licensestring

The dataset license

license_titlestring

The dataset license human-readable title

license_urlstring

The dataset license URL

metricsobject

The dataset metrics

pagestring

The dataset web page URL

privateboolean

Is the dataset private to the owner or the organization

qualityobject

The dataset quality

slugstring

The dataset permalink string

tagsstring[]
titlestring required

The dataset title

uristring

The API URI for this dataset

Example response

{
  "access_audiences": [
    {
      "condition": "yes",
      "role": "local_authority_and_administration"
    }
  ],
  "community_resources": [
    {
      "checksum": {
        "type": "sha1"
      },
      "filetype": "file",
      "type": "main"
    }
  ],
  "contact_points": [
    {
      "role": "contact"
    }
  ],
  "frequency": "continuous",
  "resources": [
    {
      "checksum": {
        "type": "sha1"
      },
      "filetype": "file",
      "type": "main"
    }
  ],
  "spatial": {
    "geom": {
      "type": "Point"
    }
  }
}

Changes

  • 8a6c4a5665e6Revision changes
    • breaking

      removed the success response with the status

    • info

      added the success response with the status