Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion guides/authentication.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ tags:
- api keys
- tenancy
- security
timestamp: 2026-06-19T00:00:00Z
timestamp: 2026-06-20T00:00:00Z
---

Authenticate with a tenant **API key** sent as a Bearer token:
Expand Down
2 changes: 1 addition & 1 deletion guides/conformance.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ tags:
- conformance
- standards
- honesty
timestamp: 2026-06-19T00:00:00Z
timestamp: 2026-06-20T00:00:00Z
---

OpenDPP is deliberately precise about what it claims. In short:
Expand Down
2 changes: 1 addition & 1 deletion guides/errors.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ tags:
- errors
- validation
- troubleshooting
timestamp: 2026-06-19T00:00:00Z
timestamp: 2026-06-20T00:00:00Z
---

Authenticated endpoints return `{ success: false, error, message }` (some endpoints, and all
Expand Down
2 changes: 1 addition & 1 deletion guides/interop-aas-untp.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ tags:
- IDTA
- UNTP
- data integrity
timestamp: 2026-06-19T00:00:00Z
timestamp: 2026-06-20T00:00:00Z
---

Public resolution is **content-negotiated**: one URL serves several representations, so a passport
Expand Down
2 changes: 1 addition & 1 deletion guides/public-access-tiers.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ tags:
- tiers
- capability tokens
- legitimate interest
timestamp: 2026-06-19T00:00:00Z
timestamp: 2026-06-20T00:00:00Z
---

Public resolution endpoints serve **tiered** views of the same URL:
Expand Down
2 changes: 1 addition & 1 deletion guides/rate-limits.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ tags:
- rate limits
- throttling
- headers
timestamp: 2026-06-19T00:00:00Z
timestamp: 2026-06-20T00:00:00Z
---

| Surface | Limit | Headers |
Expand Down
2 changes: 1 addition & 1 deletion guides/sealing-and-verification.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ tags:
- eIDAS
- merkle
- RFC 3161
timestamp: 2026-06-19T00:00:00Z
timestamp: 2026-06-20T00:00:00Z
---

OpenDPP passport seals are **eIDAS advanced electronic seals**: an ECDSA P-256 signature over a
Expand Down
2 changes: 1 addition & 1 deletion index.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ okf_version: "0.1"

# OpenDPP Integration API — Knowledge Bundle

> An OKF (Open Knowledge Format) projection of the public [OpenDPP Integration API](https://opendpp-node.eu/api-reference), for ingestion by AI agents and humans alike. Generated from [`/openapi.json`](https://opendpp-node.eu/openapi.json) (API v1.5.0).
> An OKF (Open Knowledge Format) projection of the public [OpenDPP Integration API](https://opendpp-node.eu/api-reference), for ingestion by AI agents and humans alike. Generated from [`/openapi.json`](https://opendpp-node.eu/openapi.json) (API v1.6.0).

# Concepts

Expand Down
4 changes: 2 additions & 2 deletions log.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# Log

## 2026-06-19
## 2026-06-20

**Update** — Knowledge bundle generated for OpenDPP Integration API v1.5.0. For the full per-version API contract history see [`/openapi.json`](https://opendpp-node.eu/openapi.json) and the project CHANGELOG.
**Update** — Knowledge bundle generated for OpenDPP Integration API v1.6.0. For the full per-version API contract history see [`/openapi.json`](https://opendpp-node.eu/openapi.json) and the project CHANGELOG.
52 changes: 47 additions & 5 deletions manifest.json
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
{
"okfVersion": "0.1",
"apiVersion": "1.5.0",
"generated": "2026-06-19T00:00:00Z",
"conceptCount": 196,
"apiVersion": "1.6.0",
"generated": "2026-06-20T00:00:00Z",
"conceptCount": 202,
"concepts": [
{
"path": "overview.md",
Expand Down Expand Up @@ -116,6 +116,13 @@
"description": "Unauthenticated, content-negotiated passport resolution: GS1 Digital Link paths, passport and unit pages.",
"resource": "https://opendpp-node.eu/api-reference"
},
{
"path": "tags/verifiable-credentials.md",
"type": "Reference",
"title": "Verifiable Credentials",
"description": "Issuer trust endpoints that back the UNTP Verifiable Credential representations: the workspace's did:web DID document (public keys only) and its W3C Bitstring Status List for revocation.",
"resource": "https://opendpp-node.eu/api-reference"
},
{
"path": "tags/schemas-vocabulary.md",
"type": "Reference",
Expand Down Expand Up @@ -445,11 +452,18 @@
"description": "Get the ESPR metadata schema for a product category",
"resource": "https://opendpp-node.eu/api/v1/schemas/{category}"
},
{
"path": "operations/getDppJsonLdContext.md",
"type": "API Endpoint",
"title": "Canonical resolvable JSON-LD context for passport & unit documents",
"description": "Canonical resolvable JSON-LD context for passport & unit documents",
"resource": "https://opendpp-node.eu/contexts/dpp/v1"
},
{
"path": "operations/getJsonLdContext.md",
"type": "API Endpoint",
"title": "W3C JSON-LD context document for passport terms",
"description": "W3C JSON-LD context document for passport terms",
"title": "W3C JSON-LD context document for passport terms (secondary, fixed term list)",
"description": "W3C JSON-LD context document for passport terms (secondary, fixed term list)",
"resource": "https://opendpp-node.eu/context/v1"
},
{
Expand Down Expand Up @@ -515,6 +529,20 @@
"description": "Publicly verify a passport's eIDAS seal, certificate chain and timestamp",
"resource": "https://opendpp-node.eu/api/v1/audit/verify"
},
{
"path": "operations/getTenantDidDocument.md",
"type": "API Endpoint",
"title": "Resolve a tenant's did:web DID document",
"description": "Resolve a tenant's did:web DID document",
"resource": "https://opendpp-node.eu/tenants/{tenantId}/did.json"
},
{
"path": "operations/getTenantRevocationStatusList.md",
"type": "API Endpoint",
"title": "Tenant revocation status list (W3C Bitstring Status List)",
"description": "Tenant revocation status list (W3C Bitstring Status List)",
"resource": "https://opendpp-node.eu/tenants/{tenantId}/status/revocation"
},
{
"path": "operations/listWebhookSubscriptions.md",
"type": "API Endpoint",
Expand Down Expand Up @@ -718,13 +746,27 @@
"description": "DeleteOperatorResponse",
"resource": "https://opendpp-node.eu/openapi.json#/components/schemas/DeleteOperatorResponse"
},
{
"path": "schemas/DidWebDocument.md",
"type": "Schema",
"title": "DidWebDocument",
"description": "A tenant's did:web DID document (public-key material only).",
"resource": "https://opendpp-node.eu/openapi.json#/components/schemas/DidWebDocument"
},
{
"path": "schemas/DppJsonLdContextDocument.md",
"type": "Schema",
"title": "DppJsonLdContextDocument",
"description": "The fixed W3C JSON-LD context document served by GET /context/v1: maps DigitalProductPassport, economicOperator, metadata, digitalSeal, signingPublicKey and proof to https://opendpp-node.eu/ns/dpp#… IRIs, and createdAt/updatedAt to schema.…",
"resource": "https://opendpp-node.eu/openapi.json#/components/schemas/DppJsonLdContextDocument"
},
{
"path": "schemas/DppVocabContextDocument.md",
"type": "Schema",
"title": "DppVocabContextDocument",
"description": "The canonical resolvable JSON-LD context served by GET /contexts/dpp/v1 — the context every public passport and battery-unit document references in its @context.",
"resource": "https://opendpp-node.eu/openapi.json#/components/schemas/DppVocabContextDocument"
},
{
"path": "schemas/EconomicOperatorNode.md",
"type": "Schema",
Expand Down
2 changes: 1 addition & 1 deletion operations/approveGrantRequest.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ resource: https://opendpp-node.eu/api/v1/grants/{id}/approve
tags:
- POST
- access-grants
timestamp: 2026-06-19T00:00:00Z
timestamp: 2026-06-20T00:00:00Z
---

`POST /api/v1/grants/{id}/approve`
Expand Down
2 changes: 1 addition & 1 deletion operations/auditEventLineage.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ resource: https://opendpp-node.eu/api/v1/events/{id}/audit
tags:
- POST
- traceability-audit
timestamp: 2026-06-19T00:00:00Z
timestamp: 2026-06-20T00:00:00Z
---

`POST /api/v1/events/{id}/audit`
Expand Down
2 changes: 1 addition & 1 deletion operations/bulkIngestPassports.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ resource: https://opendpp-node.eu/api/v1/passports/bulk
tags:
- POST
- passports
timestamp: 2026-06-19T00:00:00Z
timestamp: 2026-06-20T00:00:00Z
---

`POST /api/v1/passports/bulk`
Expand Down
2 changes: 1 addition & 1 deletion operations/createFacility.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ resource: https://opendpp-node.eu/api/v1/facilities
tags:
- POST
- facilities
timestamp: 2026-06-19T00:00:00Z
timestamp: 2026-06-20T00:00:00Z
---

`POST /api/v1/facilities`
Expand Down
2 changes: 1 addition & 1 deletion operations/createGrant.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ resource: https://opendpp-node.eu/api/v1/grants
tags:
- POST
- access-grants
timestamp: 2026-06-19T00:00:00Z
timestamp: 2026-06-20T00:00:00Z
---

`POST /api/v1/grants`
Expand Down
2 changes: 1 addition & 1 deletion operations/createPassport.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ resource: https://opendpp-node.eu/api/v1/passports
tags:
- POST
- passports
timestamp: 2026-06-19T00:00:00Z
timestamp: 2026-06-20T00:00:00Z
---

`POST /api/v1/passports`
Expand Down
2 changes: 1 addition & 1 deletion operations/createWebhookSubscription.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ resource: https://opendpp-node.eu/api/v1/webhooks/subscriptions
tags:
- POST
- webhooks
timestamp: 2026-06-19T00:00:00Z
timestamp: 2026-06-20T00:00:00Z
---

`POST /api/v1/webhooks/subscriptions`
Expand Down
2 changes: 1 addition & 1 deletion operations/deleteBatteryUnit.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ resource: https://opendpp-node.eu/api/v1/units/{id}
tags:
- DELETE
- battery-units
timestamp: 2026-06-19T00:00:00Z
timestamp: 2026-06-20T00:00:00Z
---

`DELETE /api/v1/units/{id}`
Expand Down
2 changes: 1 addition & 1 deletion operations/deleteDraftPassport.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ resource: https://opendpp-node.eu/api/v1/passports/{id}
tags:
- DELETE
- passports
timestamp: 2026-06-19T00:00:00Z
timestamp: 2026-06-20T00:00:00Z
---

`DELETE /api/v1/passports/{id}`
Expand Down
2 changes: 1 addition & 1 deletion operations/deleteFacility.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ resource: https://opendpp-node.eu/api/v1/facilities/{id}
tags:
- DELETE
- facilities
timestamp: 2026-06-19T00:00:00Z
timestamp: 2026-06-20T00:00:00Z
---

`DELETE /api/v1/facilities/{id}`
Expand Down
2 changes: 1 addition & 1 deletion operations/deleteOperator.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ resource: https://opendpp-node.eu/api/v1/operators/{id}
tags:
- DELETE
- economic-operators
timestamp: 2026-06-19T00:00:00Z
timestamp: 2026-06-20T00:00:00Z
---

`DELETE /api/v1/operators/{id}`
Expand Down
2 changes: 1 addition & 1 deletion operations/deleteWebhookSubscription.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ resource: https://opendpp-node.eu/api/v1/webhooks/subscriptions/{id}
tags:
- DELETE
- webhooks
timestamp: 2026-06-19T00:00:00Z
timestamp: 2026-06-20T00:00:00Z
---

`DELETE /api/v1/webhooks/subscriptions/{id}`
Expand Down
2 changes: 1 addition & 1 deletion operations/denyGrantRequest.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ resource: https://opendpp-node.eu/api/v1/grants/{id}/deny
tags:
- POST
- access-grants
timestamp: 2026-06-19T00:00:00Z
timestamp: 2026-06-20T00:00:00Z
---

`POST /api/v1/grants/{id}/deny`
Expand Down
2 changes: 1 addition & 1 deletion operations/getApiVersion.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ resource: https://opendpp-node.eu/api/v1/version
tags:
- GET
- service
timestamp: 2026-06-19T00:00:00Z
timestamp: 2026-06-20T00:00:00Z
---

`GET /api/v1/version`
Expand Down
2 changes: 1 addition & 1 deletion operations/getBatteryUnit.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ resource: https://opendpp-node.eu/api/v1/units/{id}
tags:
- GET
- battery-units
timestamp: 2026-06-19T00:00:00Z
timestamp: 2026-06-20T00:00:00Z
---

`GET /api/v1/units/{id}`
Expand Down
2 changes: 1 addition & 1 deletion operations/getBatteryUnitQrCode.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ resource: https://opendpp-node.eu/api/v1/units/{id}/qr
tags:
- GET
- qr-codes
timestamp: 2026-06-19T00:00:00Z
timestamp: 2026-06-20T00:00:00Z
---

`GET /api/v1/units/{id}/qr`
Expand Down
37 changes: 37 additions & 0 deletions operations/getDppJsonLdContext.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
---
type: API Endpoint
title: Canonical resolvable JSON-LD context for passport & unit documents
description: Canonical resolvable JSON-LD context for passport & unit documents
resource: https://opendpp-node.eu/contexts/dpp/v1
tags:
- GET
- schemas-vocabulary
timestamp: 2026-06-20T00:00:00Z
---

`GET /contexts/dpp/v1`

**Domain:** [Schemas & Vocabulary](/tags/schemas-vocabulary.md)
**Authentication:** **Public** — no authentication required.

Serves the stable, resolvable W3C JSON-LD `@context` (`application/ld+json`) that **every** public passport and battery-unit JSON-LD document references in its `@context` array — this is the context to dereference when expanding OpenDPP JSON-LD. It declares `@vocab: https://opendpp-node.eu/ns/dpp#` (so even dynamic metadata keys expand under the OpenDPP namespace and are never silently dropped by a strict JSON-LD processor) plus explicit term mappings for the core DPP/unit vocabulary (`DigitalProductPassport`, `BatteryUnit`, `economicOperator`, `manufacturingFacility`, `metadata`, `digitalSeal`, `signingPublicKey`, `proof`, `status`, `MerkleTreeAttestationProof`). Cacheable (`Cache-Control: public, max-age=86400`).

(The separate `/context/v1` serves an older, fixed term-only list and is **not** the context emitted documents point to.)

No authentication, no permission (public endpoint). No custom rate limiter — only the global platform limit applies (100 req/min/IP, standard `x-ratelimit-*` headers).

## Responses

- **200** — The canonical @vocab-based JSON-LD context document (fixed content). → [DppVocabContextDocument](/schemas/DppVocabContextDocument.md)
- **429** — Global rate limit exceeded (100 requests/min per IP).

## Example

```bash
curl -s \
-X GET 'https://opendpp-node.eu/contexts/dpp/v1'
```

## See also

Schemas: [DppVocabContextDocument](/schemas/DppVocabContextDocument.md).
2 changes: 1 addition & 1 deletion operations/getEventLineage.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ resource: https://opendpp-node.eu/api/v1/events/{id}/lineage
tags:
- GET
- traceability-audit
timestamp: 2026-06-19T00:00:00Z
timestamp: 2026-06-20T00:00:00Z
---

`GET /api/v1/events/{id}/lineage`
Expand Down
2 changes: 1 addition & 1 deletion operations/getFacility.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ resource: https://opendpp-node.eu/api/v1/facilities/{id}
tags:
- GET
- facilities
timestamp: 2026-06-19T00:00:00Z
timestamp: 2026-06-20T00:00:00Z
---

`GET /api/v1/facilities/{id}`
Expand Down
2 changes: 1 addition & 1 deletion operations/getHealth.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ resource: https://opendpp-node.eu/health
tags:
- GET
- service
timestamp: 2026-06-19T00:00:00Z
timestamp: 2026-06-20T00:00:00Z
---

`GET /health`
Expand Down
Loading
Loading