Aller au contenu principal
Solutions/APIs & Integration
Technical documentation

APIs & Technical DPP integration

Arianee provides documented REST APIs, SDKs and connectors to integrate the Digital Product Passport into your existing information system. Secure, high-performance and scalable architecture, with 3.4M+ passports already deployed in production.

Architecture

How the DPP integrates into your IT system

The Arianee infrastructure is organised into four independent layers. Each layer can be integrated separately according to your needs.

L1

Application Layer

REST and GraphQL APIs to create, read, update and transfer DPPs. SDKs available in JavaScript, Python and Java.

REST APIGraphQLWebhooksSDKs
L2

Business Layer

Regulatory schema validation logic, multi-actor permission management and lifecycle event orchestration.

Schema ValidationRBACEvent SourcingWorkflow Engine
L3

Data Layer

Secure distributed DPP data storage. Unique identifiers are anchored on the Arianee protocol to guarantee immutability.

Arianee ProtocolIPFSPostgreSQLE2E Encryption
L4

Integration Layer

Pre-built connectors for enterprise information systems. Support for standard industrial formats.

SAPAkeneoSalsifyGS1 Digital LinkEPCIS 2.0
API Reference

Main endpoints

Overview of the main Arianee API endpoints. Full documentation is available at docs.nmp.arianee.com.

Passports

Create, read and manage Digital Product Passports
POST/v1/passports
Create a new DPP with schema validation
POST/v1/passports/batch
Batch creation (up to 10K per request)
GET/v1/passports/{id}
Retrieve complete DPP data
PUT/v1/passports/{id}
Update data on an existing DPP

Events

Record lifecycle events
POST/v1/passports/{id}/events
Add an event (repair, resale, recycling)
GET/v1/passports/{id}/events
List all events on a DPP
GET/v1/passports/{id}/timeline
Complete lifecycle timeline

Compliance

Validation and regulatory reporting
GET/v1/passports/{id}/compliance
Check ESPR, WEEE, Battery Pass data completeness
POST/v1/compliance/validate
Validate a data schema before publication
GET/v1/reports/{type}
Generate regulatory reports

Transfers

Ownership transfer and data sharing
POST/v1/passports/{id}/transfer
Transfer ownership of a DPP
POST/v1/passports/{id}/share
Share read access with third-party actors
Security

Enterprise-grade security

The Arianee infrastructure is designed to meet the security requirements of large enterprises and European regulations.

OAuth 2.0 authentication

Every API call is authenticated via OAuth 2.0 with JWT tokens. Credentials are specific to each actor and role.

End-to-end encryption

Sensitive DPP data is encrypted in transit (TLS 1.3) and at rest (AES-256). Only authorised actors can decrypt.

Granular access control (RBAC)

Fine-grained permissions by role: manufacturer, distributor, repairer, producer responsibility organisation, authority. Each role has limited access to relevant data.

Immutable audit trail

Every action on a DPP is recorded in an immutable audit log anchored on the Arianee protocol. Complete modification traceability.

GDPR compliance

Personal data is processed in accordance with GDPR. Right to erasure, data portability and explicit consent.

SOC 2 Type II

The Arianee infrastructure is SOC 2 Type II certified. Regular security, availability and confidentiality audits.

Performance & Scalability

Proven infrastructure at scale

Arianee is the first DPP infrastructure deployed at scale in Europe, with 3.4M+ passports in production.

3.4M+Passports deployed

Total number of Digital Product Passports created on the Arianee infrastructure.

99.9%SLA Availability

Contractually guaranteed availability. Multi-region infrastructure with automatic failover.

<200msAverage latency

Median API response time under production conditions. P99 under 500ms.

10K/batchBatch creation

Maximum number of DPPs creatable in a single batch request. Asynchronous processing with callbacks.

50+Brands in production

Number of brands and companies using the Arianee infrastructure in production.

ISO 27001Certified security

Infrastructure aligned with international security standards. Regular audits.

Quick Start

Create your first DPP in a few lines

Arianee APIs are designed to be easy to use. A DPP can be created with a single HTTP request. JavaScript, Python and Java SDKs simplify integration further.

API keys available in under 24h
Test environment (sandbox) included
Interactive documentation with examples
Dedicated technical support during integration
create-passport.ts
// Create a Digital Product Passport
const response = await fetch(
  "https://api.arianee.com/v1/passports",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer <API_KEY>",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      schema: "espr-eee-v1",
      product: {
        gtin: "3700123456789",
        name: "EcoSmart Washing Machine",
        repairabilityIndex: 8.2
      }
    })
  }
);

// Response: { id, qrCodeUrl, publicUrl }

Ready to integrate the DPP?

Access the technical documentation, get your API keys and start creating Digital Product Passports in a few hours.