DAdados
datasets

Upload a new community resource

Changed on
post/datasets/{dataset}/upload/community/

Request

  • Base URL
    https://dados.gov.pt/api/1
  • URL
    https://dados.gov.pt/api/1/datasets/{dataset}/upload/community/
  • Auth
    none declared

Headers

X-Fieldsstring mask

An optional fields mask

Request body multipart/form-data

filestring binary
uuidstring
filenamestring
partindexinteger
partbyteoffsetinteger
totalpartsinteger
chunksizeinteger
totalfilesizeinteger

Response

Success

created_atstring date-time

The resource creation date

descriptionstring markdown

The resource markdown description

extrasobject

Extra attributes as key-value pairs

filesizeinteger

The resource file size in bytes

filetype'file' | 'remote' required

Whether the resource is an uploaded file, a remote file or an API

formatstring required

The resource format

idstring

The resource unique ID

last_modifiedstring date-time

The resource last modification date

lateststring

The permanent URL redirecting to the latest version of the resource. When the resource data is updated, the URL will change, the latest URL won't.

metricsobject

The resource metrics

mimestring

The resource mime type

preview_urlstring

An optional preview URL to be loaded as a standalone page (ie. iframe or new page)

titlestring required

The resource title

type'main' | 'documentation' | 'update' | 'api' | 'code' | 'other' required

Resource type (documentation, API...)

urlstring required

The resource URL

successboolean

Whether the upload succeeded or not.

Example response

{
  "checksum": {
    "type": "sha1"
  },
  "filetype": "file",
  "type": "main"
}

Changes

  • 8a6c4a5665e6Revision changes
    • breaking

      removed the success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the success response with the status