This service provides a publicly available RESTful API to access original and curated Concept Descriptions for the Asset Administration Shell.
The API provides the both read access endpoints GET /concept-descriptions/{cdIdentifier}
and GET /concept-descriptions/
as specified in the official Concept Description Repository Service Specification V3.0.1 published by the IDTA.
All concept descriptions can also be accessed via a GraphQL API which is available at the /graphql
endpoint.
Most of the endpoints require an OAuth 2.0 Bearer Token to be included in the request header. The token can be acquired via the /token
endpoint using the OAuth 2.0 Resource Owner Password Credentials Grant.
The service also allows to import existing Concept Descriptions in the JSON format and to view, manage and modify (the latter two for admins only) the stored Concept Descriptions using the FoP Consult GraphQL Frontend.
/
: Management UI (GraphQL Frontend Web App) Access/token
: OAuth 2.0 Auth Token Acquisition Endpoint (username/password grant)/help
: shows this README page rendered in the browser/docs
: Swagger UI with access to the REST API
/api/v1/api-docs
: OpenAPI JSON Schema Definition
GET /api/v1/concept-descriptions/{cdIdentifier}
: REST API endpoint for accessing a specific Concept Description with known identifier (ID) (requires Auth Token)
GET /api/v1/concept-descriptions/
: REST API endpoint for accessing all or a selection of Concept Descriptions (requires Auth Token)
/graphql
: GraphQL API endpoint. Non-admin users can only access query operations.