Skip to content

API specification for open-dpp

Contact

Servers

http://localhost:3000Local
https://api.cloud.open-dpp.deProduction

Find product data model by id

GET
/product-data-models/{productDataModelId}

Find product data model by id.

Authorizations

api_token

API key authentication

TypeAPI Key (header: api_token)

Parameters

Path Parameters

productDataModelId*

The id of the product data model.

Typestring
Required
formatuuid

Responses

application/json
JSON
{
"id": "string",
"name": "string",
"version": "string",
"sections": [
{
"id": "string",
"name": "string",
"type": "string",
"parentId": "string",
"subSections": [
"string"
],
"dataFields": [
{
"id": "string",
"name": "string",
"type": "string",
"options": {
"additionalProperties": "string"
},
"granularityLevel": "string",
"layout": {
"colStart": {
"xs": 0,
"sm": 0,
"md": 0,
"lg": 0,
"xl": 0
},
"colSpan": {
"xs": 0,
"sm": 0,
"md": 0,
"lg": 0,
"xl": 0
},
"rowStart": {
"xs": 0,
"sm": 0,
"md": 0,
"lg": 0,
"xl": 0
},
"rowSpan": {
"xs": 0,
"sm": 0,
"md": 0,
"lg": 0,
"xl": 0
}
}
}
],
"granularityLevel": "string",
"layout": {
"colStart": {
"xs": 0,
"sm": 0,
"md": 0,
"lg": 0,
"xl": 0
},
"colSpan": {
"xs": 0,
"sm": 0,
"md": 0,
"lg": 0,
"xl": 0
},
"rowStart": {
"xs": 0,
"sm": 0,
"md": 0,
"lg": 0,
"xl": 0
},
"rowSpan": {
"xs": 0,
"sm": 0,
"md": 0,
"lg": 0,
"xl": 0
}
}
}
],
"visibility": "string",
"createdByUserId": "string",
"ownedByOrganizationId": "string"
}

Playground

Server
Authorization
Variables
Key
Value

Samples

cURL
JavaScript
PHP
Python

Find all product data models

GET
/product-data-models

Find all product data models which either belong to the user's organization or are public.

Authorizations

api_token

API key authentication

TypeAPI Key (header: api_token)

Parameters

Query Parameters

organization*
Typestring
Required

Responses

application/json
JSON
{
"id": "string",
"name": "string",
"version": "string"
}

Playground

Server
Authorization
Variables
Key
Value

Samples

cURL
JavaScript
PHP
Python

Find items of model

GET
/organizations/{orgaId}/models/{modelId}/items

Find all item which belong to the specified model.

Authorizations

api_token

API key authentication

TypeAPI Key (header: api_token)

Parameters

Path Parameters

orgaId*

The id of the organization you are a member of.

Typestring
Required
formatuuid
modelId*

The id of the model. A item always belongs to a model.

Typestring
Required
formatuuid

Responses

application/json
JSON
[
{
"id": "string",
"uniqueProductIdentifiers": [
{
"uuid": "string",
"value": "string"
}
],
"productDataModelId": "string",
"dataValues": [
{
"value": "string",
"dataSectionId": "string",
"dataFieldId": "string",
"row": 0
}
]
}
]

Playground

Server
Authorization
Variables
Key
Value

Samples

cURL
JavaScript
PHP
Python

Create a new item

POST
/organizations/{orgaId}/models/{modelId}/items

Creates a new item for the specified model. It uses the product data model of the model.

Authorizations

api_token

API key authentication

TypeAPI Key (header: api_token)

Parameters

Path Parameters

orgaId*

The id of the organization you are a member of.

Typestring
Required
formatuuid
modelId*

The id of the model. A item always belongs to a model.

Typestring
Required
formatuuid

Responses

application/json
JSON
{
"id": "string",
"uniqueProductIdentifiers": [
{
"uuid": "string",
"value": "string"
}
],
"productDataModelId": "string",
"dataValues": [
{
"value": "string",
"dataSectionId": "string",
"dataFieldId": "string",
"row": 0
}
]
}

Playground

Server
Authorization
Variables
Key
Value

Samples

cURL
JavaScript
PHP
Python

Find item by id

GET
/organizations/{orgaId}/models/{modelId}/items/{itemId}

Find and return the item with the requested id.

Authorizations

api_token

API key authentication

TypeAPI Key (header: api_token)

Parameters

Path Parameters

orgaId*

The id of the organization you are a member of.

Typestring
Required
formatuuid
modelId*

The id of the model. A item always belongs to a model.

Typestring
Required
formatuuid
itemId*

The id of the item.

Typestring
Required
formatuuid

Responses

application/json
JSON
{
"id": "string",
"uniqueProductIdentifiers": [
{
"uuid": "string",
"value": "string"
}
],
"productDataModelId": "string",
"dataValues": [
{
"value": "string",
"dataSectionId": "string",
"dataFieldId": "string",
"row": 0
}
]
}

Playground

Server
Authorization
Variables
Key
Value

Samples

cURL
JavaScript
PHP
Python

Add data values to item

POST
/organizations/{orgaId}/models/{modelId}/items/{itemId}/data-values

Add data values to item. This method is used in the context of a repeater where a user can add new data rows resulting in data values.

Authorizations

api_token

API key authentication

TypeAPI Key (header: api_token)

Parameters

Path Parameters

orgaId*

The id of the organization you are a member of.

Typestring
Required
formatuuid
modelId*

The id of the model. A item always belongs to a model.

Typestring
Required
formatuuid
itemId*

The id of the item.

Typestring
Required
formatuuid

Request Body

application/json
JSON
[
{
"value": "string",
"dataSectionId": "string",
"dataFieldId": "string",
"row": 0
}
]

Responses

application/json
JSON
{
"id": "string",
"uniqueProductIdentifiers": [
{
"uuid": "string",
"value": "string"
}
],
"productDataModelId": "string",
"dataValues": [
{
"value": "string",
"dataSectionId": "string",
"dataFieldId": "string",
"row": 0
}
]
}

Playground

Server
Authorization
Variables
Key
Value
Body

Samples

cURL
JavaScript
PHP
Python

Modify data values of item

PATCH
/organizations/{orgaId}/models/{modelId}/items/{itemId}/data-values

Modify data values of item.

Authorizations

api_token

API key authentication

TypeAPI Key (header: api_token)

Parameters

Path Parameters

orgaId*

The id of the organization you are a member of.

Typestring
Required
formatuuid
modelId*

The id of the model. A item always belongs to a model.

Typestring
Required
formatuuid
itemId*

The id of the item.

Typestring
Required
formatuuid

Request Body

application/json
JSON
[
{
"value": "string",
"dataSectionId": "string",
"dataFieldId": "string",
"row": 0
}
]

Responses

application/json
JSON
{
"id": "string",
"uniqueProductIdentifiers": [
{
"uuid": "string",
"value": "string"
}
],
"productDataModelId": "string",
"dataValues": [
{
"value": "string",
"dataSectionId": "string",
"dataFieldId": "string",
"row": 0
}
]
}

Playground

Server
Authorization
Variables
Key
Value
Body

Samples

cURL
JavaScript
PHP
Python

Find models of organization

GET
/organizations/{orgaId}/models

Find all models which belong to the provided organization.

Authorizations

api_token

API key authentication

TypeAPI Key (header: api_token)

Parameters

Path Parameters

orgaId*

The id of the organization you are a member of.

Typestring
Required
formatuuid

Responses

application/json
JSON
[
{
"id": "string",
"name": "string",
"description": "string",
"productDataModelId": "string",
"uniqueProductIdentifiers": [
{
"uuid": "string",
"value": "string"
}
],
"dataValues": [
{
"value": "string",
"dataSectionId": "string",
"dataFieldId": "string",
"row": 0
}
],
"owner": "string"
}
]

Playground

Server
Authorization
Variables
Key
Value

Samples

cURL
JavaScript
PHP
Python

Create model

POST
/organizations/{orgaId}/models

Create a model

Authorizations

api_token

API key authentication

TypeAPI Key (header: api_token)

Parameters

Path Parameters

orgaId*

The id of the organization you are a member of.

Typestring
Required
formatuuid

Request Body

application/json
JSON
{
"name": "string",
"description": "string"
}

Responses

application/json
JSON
{
"id": "string",
"name": "string",
"description": "string",
"productDataModelId": "string",
"uniqueProductIdentifiers": [
{
"uuid": "string",
"value": "string"
}
],
"dataValues": [
{
"value": "string",
"dataSectionId": "string",
"dataFieldId": "string",
"row": 0
}
],
"owner": "string"
}

Playground

Server
Authorization
Variables
Key
Value
Body

Samples

cURL
JavaScript
PHP
Python

Find model by id

GET
/organizations/{orgaId}/models/{modelId}

Find model by id.

Authorizations

api_token

API key authentication

TypeAPI Key (header: api_token)

Parameters

Path Parameters

orgaId*

The id of the organization you are a member of.

Typestring
Required
formatuuid
modelId*

The id of the model. A item always belongs to a model.

Typestring
Required
formatuuid

Responses

application/json
JSON
{
"id": "string",
"name": "string",
"description": "string",
"productDataModelId": "string",
"uniqueProductIdentifiers": [
{
"uuid": "string",
"value": "string"
}
],
"dataValues": [
{
"value": "string",
"dataSectionId": "string",
"dataFieldId": "string",
"row": 0
}
],
"owner": "string"
}

Playground

Server
Authorization
Variables
Key
Value

Samples

cURL
JavaScript
PHP
Python

Update model

PATCH
/organizations/{orgaId}/models/{modelId}

Update model's name and description.

Authorizations

api_token

API key authentication

TypeAPI Key (header: api_token)

Parameters

Path Parameters

orgaId*

The id of the organization you are a member of.

Typestring
Required
formatuuid
modelId*

The id of the model. A item always belongs to a model.

Typestring
Required
formatuuid

Request Body

application/json
JSON
{
"name": "string",
"description": "string"
}

Responses

application/json
JSON
{
"id": "string",
"name": "string",
"description": "string",
"productDataModelId": "string",
"uniqueProductIdentifiers": [
{
"uuid": "string",
"value": "string"
}
],
"dataValues": [
{
"value": "string",
"dataSectionId": "string",
"dataFieldId": "string",
"row": 0
}
],
"owner": "string"
}

Playground

Server
Authorization
Variables
Key
Value
Body

Samples

cURL
JavaScript
PHP
Python

Assign product data model

POST
/organizations/{orgaId}/models/{modelId}/product-data-models/{productDataModelId}

Assign product data model to model.

Authorizations

api_token

API key authentication

TypeAPI Key (header: api_token)

Parameters

Path Parameters

orgaId*

The id of the organization you are a member of.

Typestring
Required
formatuuid
modelId*

The id of the model. A item always belongs to a model.

Typestring
Required
formatuuid
productDataModelId*

The id of the product data model.

Typestring
Required
formatuuid

Responses

application/json
JSON
{
"id": "string",
"name": "string",
"description": "string",
"productDataModelId": "string",
"uniqueProductIdentifiers": [
{
"uuid": "string",
"value": "string"
}
],
"dataValues": [
{
"value": "string",
"dataSectionId": "string",
"dataFieldId": "string",
"row": 0
}
],
"owner": "string"
}

Playground

Server
Authorization
Variables
Key
Value

Samples

cURL
JavaScript
PHP
Python

Add data values to model

POST
/organizations/{orgaId}/models/{modelId}/data-values

Add data values to model. This method is used in the context of a repeater where a user can add new data rows resulting in data values.

Authorizations

api_token

API key authentication

TypeAPI Key (header: api_token)

Parameters

Path Parameters

orgaId*

The id of the organization you are a member of.

Typestring
Required
formatuuid
modelId*

The id of the model. A item always belongs to a model.

Typestring
Required
formatuuid

Request Body

application/json
JSON
[
{
"value": "string",
"dataSectionId": "string",
"dataFieldId": "string",
"row": 0
}
]

Responses

application/json
JSON
{
"id": "string",
"name": "string",
"description": "string",
"productDataModelId": "string",
"uniqueProductIdentifiers": [
{
"uuid": "string",
"value": "string"
}
],
"dataValues": [
{
"value": "string",
"dataSectionId": "string",
"dataFieldId": "string",
"row": 0
}
],
"owner": "string"
}

Playground

Server
Authorization
Variables
Key
Value
Body

Samples

cURL
JavaScript
PHP
Python

Modify data values of model

PATCH
/organizations/{orgaId}/models/{modelId}/data-values

Modify data values of model.

Authorizations

api_token

API key authentication

TypeAPI Key (header: api_token)

Parameters

Path Parameters

orgaId*

The id of the organization you are a member of.

Typestring
Required
formatuuid
modelId*

The id of the model. A item always belongs to a model.

Typestring
Required
formatuuid

Request Body

application/json
JSON
[
{
"value": "string",
"dataSectionId": "string",
"dataFieldId": "string",
"row": 0
}
]

Responses

application/json
JSON
{
"id": "string",
"name": "string",
"description": "string",
"productDataModelId": "string",
"uniqueProductIdentifiers": [
{
"uuid": "string",
"value": "string"
}
],
"dataValues": [
{
"value": "string",
"dataSectionId": "string",
"dataFieldId": "string",
"row": 0
}
],
"owner": "string"
}

Playground

Server
Authorization
Variables
Key
Value
Body

Samples

cURL
JavaScript
PHP
Python

Powered by VitePress OpenAPI