> For the complete documentation index, see [llms.txt](https://open-dataspaces.gitbook.io/ods-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://open-dataspaces.gitbook.io/ods-docs/odp/v1.md).

# Open Data Spaces Protocols (ODP)

## Overview

This repository manages the official protocol specification (Normative Document) that technically clarifies interoperable communication procedures (Protocols), with reference to the Open Dataspaces Reference Architecture Model (ODS-RAM) and in alignment with its design principles.

The purpose of this document is to translate the functional requirements defined in each layer of the ODS-RAM into concrete protocol specifications, thereby providing clear and implementable specifications to ensure consistent compliance by implementers.

***

## Document Structure

Each protocol is defined using a two-layer structure consisting of a logical definition (Protocol) and an implementation example mapped to a specific technology stack (Binding).

* **Protocol (Abstract Specification)**: Defines technology-agnostic logical message models, normative requirements, and state transitions.
* **Binding (Concrete Specification)**: Describes implementation examples when mapped to actual communication mechanisms (e.g., HTTPS/JSON), including common headers and error mappings.

Detailed API interface specifications (such as endpoints, detailed parameters, and schemas) are not included in this document. For implementation purposes, please refer to the separately published **API Specification**.

***

## Terminology

Refer to the glossary of the ODS-RAM.

***

## Related Standards and Documents

* [ODS-RAM（Japanese）](https://open-dataspaces.gitbook.io/ods-docs/ods-ram/) / [ODS-RAM（English）](https://open-dataspaces.gitbook.io/ods-docs/en/ods-ram/)
* [Existing W3C Standards](https://www.w3.org/) ([RDF](https://www.w3.org/RDF/), [JSON-LD](https://www.w3.org/TR/json-ld11/), etc.)
* [OAuth 2.0](https://oauth.net/2/)
* [OpenID Connect](https://openid.net/developers/specs/)
* [ISO/IEC Directives, Part 2 (Edition 9)](https://www.iec.ch/system/files/2021-07/isoiecdir2%7Bed9.0.rlv%7Den.pdf)

***

## Copyright

Copyright of ODP belongs to IPA, METI, and NEDO. ODP was compiled and edited by IPA based on the outcomes of NEDO's "Project for the Development and Pilot of a Data Sharing System to Realize the Ouranos Ecosystem."

## License

This document (ODP) is provided under the Creative Commons Attribution 4.0 International (CC BY 4.0).\
Full license text: <https://creativecommons.org/licenses/by/4.0/>

Components released as open-source software (OSS) SHALL follow the respective licenses defined in each repository.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://open-dataspaces.gitbook.io/ods-docs/odp/v1.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.