Entity definition

Each entity definition in the system is represented by an Entity Definition Resource, that can be used to retrieve the state of the entity definition, as well as update it and delete it.

Methods supported: GETHEADPUTDELETE.

GET /api/entitydefinitions/name

Returns an Entity Definition Object that contains the state of the entity definition.

Example Request:

RequestResponse

GET http://<hostname>/api/entitydefinitions/EntityDefinition1
Host: hostname
Accept: application/json

Example Response:

RequestResponse

HTTP/1.1 200 OK
Content-Length: content length
Content-Type: application/json; charset=utf-8
ETag: "hash string"

{
    "id":298,
    "name":"EntityDefinition1",
    "member_groups":[
        {
            "name":"New member group",
            "labels":{
                "en-US":"New member group",
                "nl-BE":"Nieuwe onderdeel groep"
            },
            "members":[
                {
                    "type":"String"
                    "name":"New string property"
                },
                ...
            ]
        },
        ...
    ],
    "self":{
        "href":"http://<hostname>/api/entitydefinitions/EntityDefinition1"
    },
    "entities":{
        "href":"http://<hostname>/api/entitydefinitions/EntityDefinition1/entities"
    }
}

PUT /api/entitydefinitions/name

Updates an entity definition with the state submitted in the request. If successful, the server responds with 204 No Content. The request body must contain an Entity Definition Object, and all properties are required. If a property is not present its value is removed. Any members not included are removed.

Example Request:

RequestResponse

PUT http://<hostname>/api/entitydefinitions/EntityDefinition1
Host: hostname
Content-Type: application/json

{
    "member_groups":[
        {
            "labels":{
                "nl-NL":"Nieuwe onderdeel groep"
            }
        }
    ]
}

Example Response

RequestResponse

HTTP/1.1 204 No Content

DELETE /api/entitydefinitions/name

Deletes the entity definition. If successful, the server responds with 204 No Content.

Example Request:

RequestResponse

DELETE http://<hostname>/api/entitydefinitions/EntityDefinition1
Host: hostname

Example Response:

RequestResponse

HTTP/1.1 204 No Content

Do you have some feedback for us?

If you have suggestions for improving this article,