## 授權機制
[授權機制](授權機制)
## 實體類接口
#### 獲取實體類列表
**Request**
```
GET /agents/{agentId}/entityTypes
```
**Path parameters**
| Parameters | |
| -------- | -------- |
| agentId | Agent ID |
**Url parameters**
| Parameters | |
| -------- | -------- |
| page | 頁碼，從0開始，default: 0 |
| size | 每頁記錄數， default: 20 |
**Request body**
```
EMPTY
```
**Response body**
```json
{
"content": [
object(EntityType)
],
"pagination": {
"totalElements": number,
"page": number,
"size": number
}
}
```
> resource <a href = "#EntityType">EntityType</a>
#### 獲取實體類信息
**Request**
```
GET /agents/{agentId}/entityTypes/{entityTypeId}
```
**Path parameters**
| Parameters | |
| -------- | -------- |
| agentId | Agent ID |
| entityTypeId | Entity Type ID |
**Request body**
```
EMPTY
```
**Response body**
> object(<a href="#EntityType">EntityType</a>)
#### 創建實體類
**Request**
```
POST /agents/{agentId}/entityTypes
```
**Path parameters**
| Parameters | |
| -------- | -------- |
| agentId | Agent ID |
**Request body**
> object(<a href="#EntityTypeInput">EntityTypeInput</a>)
**Response body**
> object(<a href="#EntityType">EntityType</a>)
#### 修改實體類信息
**Request**
```
POST /agents/{agentId}/entityTypes/{entityTypeId}
```
**Path parameters**
| Parameters | |
| -------- | -------- |
| agentId | Agent ID |
| entityTypeId | Entity Type ID |
**Request body**
> object(<a href="#EntityTypeInput">EntityTypeInput</a>)
**Response body**
> object(<a href="#EntityType">EntityType</a>)
#### 刪除實體類
**Request**
```
DELETE /agents/{agentId}/entityTypes/{entityTypeId}
```
**Path parameters**
| Parameters | |
| -------- | -------- |
| agentId | Agent ID |
| entityTypeId | Entity Type ID |
**Request body**
```
EMPTY
```
**Response body**
```
EMPTY
```
## 實體接口
#### 獲取實體列表
**Request**
```
GET /agents/{agentId}/entityTypes/{entityTypeId}/entities
```
**Path parameters**
| Parameters | |
| -------- | -------- |
| agentId | Agent ID |
| entityTypeId | Entity Type ID |
**Url parameters**
| Parameters | |
| -------- | -------- |
| page | 頁碼，從0開始，default: 0 |
| size | 每頁記錄數， default: 20 |
**Request body**
```
EMPTY
```
**Response body**
```json
{
"content": [
object(Entity)
]
"pagination": {
"totalElements": number,
"page": number,
"size": number
}
}
```
> resource <a href = "#Entity">Entity</a>
#### 獲取實體信息
**Request**
```
GET /agents/{agentId}/entityTypes/{entityTypeId}/entities/{entityId}
```
**Path parameters**
| Parameters | |
| -------- | -------- |
| agentId | Agent ID |
| entityTypeId | Entity Type ID |
| entityId | Entity ID |
**Request body**
```
EMPTY
```
**Response body**
> object(<a href="#Entity">Entity</a>)
#### 創建實體
**Request**
```
POST /agents/{agentId}/entityTypes/{entityTypeId}/entities
```
**Path parameters**
| Parameters | |
| -------- | -------- |
| agentId | Agent ID |
| entityTypeId | Entity Type ID |
**Request body**
> object(<a href="EntityInput">EntityInput</a>)
**Response body**
> object(<a href="#Entity">Entity</a>)
#### 修改實體信息
**Request**
```
POST /agents/{agentId}/entityTypes/{entityTypeId}/entities/{entityId}
```
**Path parameters**
| Parameters | |
| -------- | -------- |
| agentId | Agent ID |
| entityTypeId | Entity Type ID |
| entityId | Entity ID |
**Request body**
> object(<a href="EntityInput">EntityInput</a>)
**Response body**
> object(<a href="#Entity">Entity</a>)
#### 刪除實體
**Request**
```
DELETE /agents/{agentId}/entityTypes/{entityTypeId}/entities/{entityId}
```
**Path parameters**
| Parameters | |
| -------- | -------- |
| agentId | Agent ID |
| entityTypeId | Entity Type ID |
| entityId | Entity ID |
**Request body**
```
EMPTY
```
**Response body**
```
EMPTY
```
## Resource
### <a name="EntityType">EntityType</a>
```json
{
"id": string,
"name": string,
"entities": {"href": "/agents/{agentId}/entityTypes/{entityTypeId}/entities"}
}
```
### <a name="EntityTypeInput">EntityTypeInput</a>
```json
{
"name": string
}
```
### <a name="Entity">Entity</a>
```json
{
"id": string,
"name": string,
"alternateName": [string]
}
```
### <a name="EntityInput">EntityInput</a>
```json
{
"name": string,
"alternateName": [string]
}
```
