uData API
Luxembourgish Government Open Data
Government & public#government
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Luxembourgish Government Open Data
Endpoints 204
site
- GETFetch site activity, optionally filtered by user of org
/activity - GETAn OEmbed compliant API endpoint
/oembed?url=https://example.comSee: http://oembed.com/ Support datasets and reuses URLs - GETThe returned payload is a list of OEmbed formatted responses
/oembeds/?references=stringSee: http://oembed.com/ The references are composed by a keyword (kind) followed by the id each of those separated by commas. E.g:… - GETSite-wide variables
/site/ - GETRoot RDF endpoint with content negociation handling
/site/catalog - GETget_site_rdf_catalog_format
/site/catalog.:format - GETget_site_json_ld_context
/site/context.jsonld - GETRoot RDF endpoint with content negociation handling
/site/data.:format - GETList homepage datasets
/site/home/datasets/ - PUTSet the homepage datasets editorial selection
/site/home/datasets/ - GETList homepage featured reuses
/site/home/reuses/ - PUTSet the homepage reuses editorial selection
/site/home/reuses/ - GETsuggest_territory
/territory/suggest/?q=string
datasets
- GETList or search all datasets using optimized manual serialization
/datasets/ - POSTCreate a new dataset
/datasets/ - GETList all available dataset badges and their labels
/datasets/badges/ - GETList all community resources
/datasets/community_resources/ - POSTCreate a new community resource
/datasets/community_resources/ - GETRetrieve a community resource given its identifier
/datasets/community_resources/:community/ - PUTUpdate a given community resource
/datasets/community_resources/:community/ - DELETEDelete a given community resource
/datasets/community_resources/:community/ - POSTUpdate the file related to a given community resource
/datasets/community_resources/:community/upload/ - GETList all allowed resources extensions
/datasets/extensions/ - GETList all available frequencies
/datasets/frequencies/ - GETList all available licenses
/datasets/licenses/ - GETList or search all datasets
/datasets/original/ - GETRedirect to the latest version of a resource given its identifier
/datasets/r/:id - GETList all resource types
/datasets/resource_types/ - GETList all available schemas
/datasets/schemas/ - GETDatasets suggest endpoint using mongoDB contains
/datasets/suggest/?q=string - GETSuggest file formats
/datasets/suggest/formats/?q=string - GETSuggest mime types
/datasets/suggest/mime/?q=string - GETGet a dataset given its identifier
/datasets/:dataset/ - PUTUpdate a dataset given its identifier
/datasets/:dataset/ - DELETEDelete a dataset given its identifier
/datasets/:dataset/ - POSTCreate a new badge for a given dataset
/datasets/:dataset/badges/ - DELETEDelete a badge for a given dataset
/datasets/:dataset/badges/:badge_kind/ - POSTMark the dataset as featured
/datasets/:dataset/featured/ - DELETEUnmark the dataset as featured
/datasets/:dataset/featured/ - GETrdf_dataset
/datasets/:dataset/rdf - GETrdf_dataset_format
/datasets/:dataset/rdf.:format - PUTReorder resources
/datasets/:dataset/resources/ - POSTCreate a new resource for a given dataset
/datasets/:dataset/resources/ - GETGet a resource given its identifier
/datasets/:dataset/resources/:rid/ - PUTUpdate a given resource on a given dataset
/datasets/:dataset/resources/:rid/ - DELETEDelete a given resource on a given dataset
/datasets/:dataset/resources/:rid/ - GETChecks that a resource's URL exists and returns metadata
/datasets/:dataset/resources/:rid/check/ - POSTUpload a file related to a given resource on a given dataset
/datasets/:dataset/resources/:rid/upload/ - POSTUpload a new dataset resource
/datasets/:dataset/upload/ - POSTUpload a new community resource
/datasets/:dataset/upload/community/ - GETList all followers for a given object
/datasets/:id/followers/ - POSTFollow an object given its ID
/datasets/:id/followers/Returns the number of followers left after the operation - DELETEUnfollow an object given its ID
/datasets/:id/followers/Returns the number of followers left after the operation
reuses
- GETlist_reuses
/reuses/ - POSTcreate_reuse
/reuses/ - GETList all available reuse badges and their labels
/reuses/badges/ - GETReuses suggest endpoint using mongoDB contains
/reuses/suggest/?q=string - GETList all reuse topics
/reuses/topics/ - GETList all reuse types
/reuses/types/ - GETList all followers for a given object
/reuses/:id/followers/ - POSTFollow an object given its ID
/reuses/:id/followers/Returns the number of followers left after the operation - DELETEUnfollow an object given its ID
/reuses/:id/followers/Returns the number of followers left after the operation - GETFetch a given reuse
/reuses/:reuse/ - PUTUpdate a given reuse
/reuses/:reuse/ - DELETEDelete a given reuse
/reuses/:reuse/ - POSTCreate a new badge for a given reuse
/reuses/:reuse/badges/ - DELETEDelete a badge for a given reuse
/reuses/:reuse/badges/:badge_kind/ - POSTAdd a dataset to a given reuse
/reuses/:reuse/datasets/ - POSTMark a reuse as featured
/reuses/:reuse/featured/ - DELETEUnmark a reuse as featured
/reuses/:reuse/featured/ - POSTUpload a new reuse image
/reuses/:reuse/image
contacts
- POSTCreates a contact point
/contacts/ - GETGet a contact point given its identifier
/contacts/:contact_point/ - PUTUpdates a contact point given its identifier
/contacts/:contact_point/ - DELETEDeletes a contact point given its identifier
/contacts/:contact_point/
spam
- GETGet all potential spam objects
/spam/ - POSTCheck the MCaptcha token from an app component
/spam/check
discussions
- GETList all Discussions
/discussions/ - POSTCreate a new Discussion
/discussions/ - GETGet a discussion given its ID
/discussions/:id/ - POSTAdd comment and optionally close a discussion given its ID
/discussions/:id/ - DELETEDelete a discussion given its ID
/discussions/:id/ - DELETEDelete a comment given its index
/discussions/:id/comments/:cidx - DELETEMark a potential spam as no spam
/discussions/:id/comments/:cidx/spam - DELETEMark a potential spam as no spam
/discussions/:id/spam/
organizations
- GETList or search all organizations
/organizations/ - POSTCreate a new organization
/organizations/ - GETList all available organization badges and their labels
/organizations/badges/ - GETList all possible organization roles
/organizations/roles/ - GETOrganizations suggest endpoint using mongoDB contains
/organizations/suggest/?q=string - GETList all followers for a given object
/organizations/:id/followers/ - POSTFollow an object given its ID
/organizations/:id/followers/Returns the number of followers left after the operation - DELETEUnfollow an object given its ID
/organizations/:id/followers/Returns the number of followers left after the operation - GETGet a organization given its identifier
/organizations/:org/ - PUTUpdate a organization given its identifier
/organizations/:org/ - DELETEDelete a organization given its identifier
/organizations/:org/ - POSTCreate a new badge for a given organization
/organizations/:org/badges/ - DELETEDelete a badge for a given organization
/organizations/:org/badges/:badge_kind/ - GETrdf_organization
/organizations/:org/catalog - GETrdf_organization_format
/organizations/:org/catalog.:format - GETList all organization contact points
/organizations/:org/contacts/ - GETList organization datasets (including private ones when member)
/organizations/:org/datasets/ - GETList organization discussions
/organizations/:org/discussions/ - PUTSet the logo BBox
/organizations/:org/logo - POSTUpload a new logo
/organizations/:org/logo - PUTUpdate member status into a given organization
/organizations/:org/member/:user - POSTAdd a member into a given organization
/organizations/:org/member/:user - DELETEDelete member from an organization
/organizations/:org/member/:user - GETList membership requests for a given organization
/organizations/:org/membership/ - POSTApply for membership to a given organization
/organizations/:org/membership/ - POSTAccept user membership to a given organization
/organizations/:org/membership/:id/accept/ - POSTRefuse user membership to a given organization
/organizations/:org/membership/:id/refuse/ - GETList organization reuses (including private ones when member)
/organizations/:org/reuses/
spatial
- GETList each zone for a given level with their datasets count
/spatial/coverage/:level/ - GETList all known spatial granularities
/spatial/granularities/ - GETList all known levels
/spatial/levels/ - GETFetch a zone
/spatial/zone/:id/ - GETFetch datasets for a given zone
/spatial/zone/:id/datasets/ - GETGeospatial zones suggest endpoint using mongoDB contains
/spatial/zones/suggest/?q=string - GETFetch a zone list as GeoJSON
/spatial/zones/:ids/
users
- GETList all users
/users/ - POSTCreate a new object
/users/ - GETList all possible user roles
/users/roles/ - GETSuggest users
/users/suggest/?q=string - GETList all followers for a given object
/users/:id/followers/ - POSTFollow a user given its ID
/users/:id/followers/ - DELETEUnfollow an object given its ID
/users/:id/followers/Returns the number of followers left after the operation - GETGet a user given its identifier
/users/:user/ - PUTUpdate a user given its identifier
/users/:user/ - DELETEDelete a user given its identifier
/users/:user/ - POSTUpload a new avatar for a given user
/users/:user/avatar - GETList all user contact points
/users/:user/contacts/
me
- GETFetch the current user (me) identity
/me/ - PUTUpdate my profile
/me/ - DELETEDelete my profile
/me/ - POST(Re)Generate my API Key
/me/apikey - DELETEClear/destroy an apikey
/me/apikey - POSTUpload a new avatar
/me/avatar - GETList all my datasets (including private ones)
/me/datasets/ - GETFetch the current user (me) metrics
/me/metrics/ - GETList all community resources related to me and my organizations
/me/org_community_resources/ - GETList all datasets related to me and my organizations
/me/org_datasets/ - GETList all discussions related to my organizations
/me/org_discussions/ - GETList all reuses related to me and my organizations
/me/org_reuses/ - GETList all my reuses (including private ones)
/me/reuses/
dataservices
- GETList or search all dataservices
/dataservices/ - POSTcreate_dataservice
/dataservices/ - GETget_dataservice
/dataservices/:dataservice/ - DELETEdelete_dataservice
/dataservices/:dataservice/ - PATCHupdate_dataservice
/dataservices/:dataservice/ - POSTdataservice_datasets_create
/dataservices/:dataservice/datasets/ - DELETEdelete_dataservice_dataset_api_/dataservices/<dataservice:dataservice>/datasets/<dataset:dataset>/
/dataservices/:dataservice/datasets/:dataset/ - GETrdf_dataservice
/dataservices/:dataservice/rdf - GETrdf_dataservice_format
/dataservices/:dataservice/rdf.:format - GETList all followers for a given object
/dataservices/:id/followers/ - POSTFollow an object given its ID
/dataservices/:id/followers/Returns the number of followers left after the operation - DELETEUnfollow an object given its ID
/dataservices/:id/followers/Returns the number of followers left after the operation
workers
- GETList all scheduled jobs
/workers/jobs/ - POSTCreate a new scheduled job
/workers/jobs/ - GETList all schedulable jobs
/workers/jobs/schedulables - GETFetch a single scheduled job
/workers/jobs/:id - PUTUpdate a single scheduled job
/workers/jobs/:id - DELETEDelete a single scheduled job
/workers/jobs/:id - GETGet a tasks status given its ID
/workers/tasks/:id
reports
- GETlist_reports
/reports/ - POSTcreate_report
/reports/ - GETlist_reports_reasons
/reports/reasons/ - GETget_report
/reports/:report/
tags
- GETSuggest tags
/tags/suggest/?q=string
topics
- GETList all topics
/topics/ - POSTCreate a topic
/topics/ - GETGet a given topic
/topics/:topic/ - PUTUpdate a given topic
/topics/:topic/ - DELETEDelete a given topic
/topics/:topic/
posts
- GETList all posts
/posts/ - POSTCreate a post
/posts/ - GETGet a given post
/posts/:post/ - PUTUpdate a given post
/posts/:post/ - DELETEDelete a given post
/posts/:post/ - PUTSet the image BBox
/posts/:post/image - POSTUpload a new image
/posts/:post/image - POSTPublish an existing post
/posts/:post/publish - DELETEPublish an existing post
/posts/:post/publish
transfer
- GETList all transfer requests
/transfer/ - POSTInitiate transfer request
/transfer/ - GETFetch a transfer request given its identifier
/transfer/:id/ - POSTRespond to a transfer request
/transfer/:id/
notifications
- GETList all current user pending notifications
/notifications/
avatars
- GETGet a deterministic avatar given an identifier at a given size
/avatars/:identifier/:size
harvest
- GETList all available harvest backends
/harvest/backends - GETList all jobs for a given source
/harvest/job/:ident/ - GETList all available harvesters
/harvest/job_status - POSTPreview an harvesting from a source created with the given payload
/harvest/source/preview - GETGet a single source given an ID or a slug
/harvest/source/:ident - PUTUpdate a harvest source
/harvest/source/:ident - DELETEdelete_harvest_source
/harvest/source/:ident - GETList all jobs for a given source
/harvest/source/:ident/jobs/ - GETPreview a single harvest source given an ID or a slug
/harvest/source/:ident/preview - POSTrun_harvest_source
/harvest/source/:ident/run - POSTSchedule an harvest source
/harvest/source/:ident/schedule - DELETEUnschedule an harvest source
/harvest/source/:ident/schedule - POSTValidate or reject an harvest source
/harvest/source/:ident/validate - GETList all harvest sources
/harvest/sources/ - POSTCreate a new harvest source
/harvest/sources/
API details
- Base URL
https://data.public.lu/api/1- Authentication
- An API key in the X-API-KEY header
- Operations
- 204 operations on 139 pathsGET 104POST 49DELETE 32PUT 18PATCH 1
- Main resources
- datasets 40organizations 28reuses 18harvest 15me 13site 13dataservices 12users 12posts 9discussions 8
- Response formats
application/json- Description format
- Swagger 2.0, API version
1.0 - Links
- OpenAPI document
- Listed from
- Public's published OpenAPI description
How to test the uData API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the uData API collection, without the publisher's secrets.
- Add your credentialsThis API uses an API key in the X-API-KEY header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Fetch site activity, optionally filtered by user of org” (GET /activity), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the uData API?
Luxembourgish Government Open Data It is listed under Government & public and has 204 endpoints.
Who publishes the uData API?
It is listed from Public's public API description (an OpenAPI document), not published by Public on Swastik Codes. Anyone who controls data.public.lu can claim the profile by adding a DNS TXT record.
What is the base URL of the uData API?
Requests go to https://data.public.lu/api/1. Endpoint paths are added to this base URL.
How do I authenticate with the uData API?
With an API key in the X-API-KEY header.
How many endpoints does the uData API have?
204 operations on 139 paths (104 GET, 49 POST, 32 DELETE, 18 PUT, 1 PATCH). The largest groups are datasets, organizations, reuses, harvest.
Is forking the uData API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.