LogoLogo
  • Introduction
  • Background
    • The GDPR
    • Data Request Practice
  • Why a Data Request API
    • Security
    • Modularisation
    • Best practices
    • A great user experience
  • Proposal
    • Goals
    • API Formatting
    • Authentication
    • Describing Data
  • Future Considerations
    • Governance
    • API Extensions
    • Certification
    • Security
    • Reference Implementations
    • Data Rights Registry
    • Iconography
Powered by GitBook
On this page
  • Authentication
  • Data Endpoint
  • Settings Endpoint
  • Requests Endpoint
Export as PDF
  1. Proposal

API Formatting

PreviousGoalsNextAuthentication

Last updated 4 years ago

This page describes the structure of the public API that must be exposed by a Open Data Rights-compliant API. The API endpoint is described in the . Please find a detailed overview of responses, parameters and endpoint in the .

The API consists is REST-based, and can be operated language-agnostically. All responses are either in application/json , text/plain or application/zip for specialised endpoints. Any POST parameters must always be supplied in a application/json request body. Requests which require authentication must follow OAuth standards, with use of a Bearer-token on the Authorization header.

Authentication

Authentication for this API is OAuth based, and are described more intricately on the Authentication page:

This endpoint describes the data practices of the organisation, as well as how those practices impact the user. The inner workings of the data endpoint are documented on the Describing Data page:

The settings endpoint describes the operation criteria for the specific instance of the Open Data Rights API. The available parameters, along with implementation instructions are available as part of the API Endpoint documentation.

This endpoint describes currently ongoing requests, how to request a new archive, archive status and archive download when the request is complete. As part of a new request a third party may supply a JSON array with all context-types that are requested from the organisation for the user. If no request body is supply, all processed data types are requested for the authenticated user.

Open API 3 standard in the GitHub repository
API Endpoint Documentation
Authentication
Data Endpoint
Describing Data
Settings Endpoint
Requests Endpoint