In this article
Get schema by Id and Version
Returns an unique active schema type of particular version for given id and version
Format is as specified in http://json-schema.org/documentation.html (draft 6)
Sample – refer here http://json-schema.org/examples.html
URL
https://{{HOST}}/apollo/schema/entitytypes/{id}/versions/{ver}
https://{{HOST}}/apollo/schema/relationshiptypes/{id}/versions/{ver}
https://{{HOST}}/apollo/schema/messagetypes/{id}/versions/{ver}
https://{{HOST}}/apollo/schema/eventtypes/{id}/versions/{ver}
Method
GET
Required IMS Scopes
- apollo_read
URL Path Parameters
| Name | Description | Example | Type |
|---|---|---|---|
| id required |
Unique id of schema | /entitytypes/id | string |
| ver required |
Version of schema | /entitytypes/id/versions/ver | string |
URL Query Parameters
| Name | Description | Example | Type |
|---|---|---|---|
| v optional |
Service Version | /entitytypes/id?v=1.0 | Number |
| includeSystemData optional |
Flag to indicate if result should have system data field (default false) | /entitytypes/id/versions/ver?includeSystemData=true | Boolean |
Request Header Parameters
| Type | Value | Description |
|---|---|---|
| Authorization required |
Bearer {access_token} | IMS access token |
Example
Request
curl -X GET
'https://{{HOST}}/apollo/schema/entitytypes/{entityTypes}/versions/{ver}?includeSystemData=false'
-H 'Authorization: Bearer {access_token}'
Response
{
"status": {
"message": "Operation completed",
"code": "200"
},
"transactionId": "5BB888CE813F4BB4B39A49777F086AA9",
"data": {
"schema": {
"$schema": "http://json-schema.org/draft-06/schema#",
"description": "Schema for Entity BRICK_0_4__Building",
"additionalProperties": false,
"type": "object",
"title": "BRICK_0_4__Building",
"required": [
"id",
"name"
],
"properties": {
"name": {
"description": "source entity id",
"type": "string"
},
"id": {
"description": "The unique identifier for the relation",
"type": "string"
}
}
}
},
"paging": null
}
Errors
| Error | Description |
|---|---|
| 403 | Unauthorized – token expired / invalid |
| 404 | Active schema not found for given id |
| 500 | Any other error e.g. DB operation failed |
Response Body Parameters
| Name | Description | Schema |
|---|---|---|
| schema | Schema body | Json |
| sysData | System fields | String |