競爭管理
新增競爭
- API 地址:
compete/add - HTTP 方法:POST
- 授權(quán)方式:通用授權(quán)
請求參數(shù)
| 參數(shù) | 類型 | 是否必須 | 參數(shù)說明 |
|---|---|---|---|
| op_user | string(40) | 是 | 操作用戶ID。可通過 用戶列表 接口獲取 |
| POST流 | json(map) | 是 | POST 方法提交的流數(shù)據(jù),字段與值的鍵值對,例如 { "competeName":"XX易" }字段可通過 元數(shù)據(jù) 接口獲取 |
返回數(shù)據(jù)示例
{
"error_code": 0,
"error_msg": "調(diào)用成功",
"data": {
"compete_id": "xxx"
}
}
返回數(shù)據(jù)說明
| 字段 | 類型 | 字段說明 |
|---|---|---|
| compete_id | string(40) | 新增競爭的唯一ID,為 40 位 hash 字符串 |
獲取單條競爭
- API 地址:
compete/get - HTTP 方法:GET
- 授權(quán)方式:通用授權(quán)
請求參數(shù)
| 參數(shù) | 類型 | 是否必須 | 參數(shù)說明 |
|---|---|---|---|
| op_user | string(40) | 是 | 操作用戶ID。可通過 用戶列表 接口獲取 |
| compete_id | string(40) | 是 | 要獲取的競爭ID |
| fields | string | 是 | 要獲取的字段列表,多個字段以逗號(,)分隔 字段可通過 元數(shù)據(jù) 接口獲取 |
返回數(shù)據(jù)示例
{
"error_code": 0,
"error_msg": "調(diào)用成功",
"data": {
"competeName": "XX易",
"itemRole": 8
}
}
返回數(shù)據(jù)說明
| 字段 | 類型 | 字段說明 |
|---|---|---|
| data | json(map) | 數(shù)據(jù)以鍵值對的形式放置在此字段 |
查詢競爭列表
- API 地址:
compete/list - HTTP 方法:GET
- 授權(quán)方式:通用授權(quán)
請求參數(shù)
| 參數(shù) | 類型 | 是否必須 | 參數(shù)說明 |
|---|---|---|---|
| op_user | string(40) | 是 | 操作用戶。可通過 用戶列表 接口獲取 |
| fields | string | 是 | 要查詢的字段列表,多個字段以逗號(,)分隔 字段請通過 元數(shù)據(jù) 接口獲取 |
| qname | string | 否 | 查詢主顯字段(name_field),支持使用星號模糊匹配,如 *企能軟件 將查詢以企能軟件結(jié)尾的競爭。如需更復雜的查詢請參考 高級查詢接口 |
| page_no | int | 否 | 頁碼,默認 1 |
| page_size | int | 否 | 頁大小,默認 20,最大 200 |
返回數(shù)據(jù)示例
{
"error_code": 0,
"error_msg": "調(diào)用成功",
"total_size": 10000,
"page_size": 20,
"page_no": 1,
"data": [
{ "competeId": "xxx", "competeName": "XX易", "itemRole": 8 },
{ "competeId": "xxx", "competeName": "XX易", "itemRole": 8 }
]
}
返回數(shù)據(jù)說明
| 字段 | 類型 | 字段說明 |
|---|---|---|
| total_size | int | 總記錄數(shù) |
| page_size | int | 查詢的頁大小 |
| page_no | int | 查詢的頁碼 |
| data | json(array) | 數(shù)據(jù)以 數(shù)組->鍵值對 的形式放置在此字段 |
修改競爭
- API 地址:
compete/update - HTTP 方法:POST
- 授權(quán)方式:通用授權(quán)
請求參數(shù)
| 參數(shù) | 類型 | 是否必須 | 參數(shù)說明 |
|---|---|---|---|
| op_user | string(40) | 是 | 操作用戶ID。可通過 用戶列表 接口獲取 |
| compete_id | string(40) | 是 | 要修改的競爭ID |
| POST流 | json(map) | 是 | POST 方法提交的流數(shù)據(jù),字段與值的鍵值對,例如 { "competeName":"XX易" }字段請通過 元數(shù)據(jù) 接口獲取 |
返回數(shù)據(jù)示例
{
"error_code": 0,
"error_msg": "調(diào)用成功",
"data": {
"compete_id": "xxx"
}
}
返回數(shù)據(jù)說明
| 字段 | 類型 | 字段說明 |
|---|---|---|
| compete_id | string(40) | 被修改的競爭ID |
刪除競爭
- API 地址:
compete/delete - HTTP 方法:POST
- 授權(quán)方式:通用授權(quán)
請求參數(shù)
| 參數(shù) | 類型 | 是否必須 | 參數(shù)說明 |
|---|---|---|---|
| op_user | string(40) | 是 | 操作用戶ID。可通過 用戶列表 接口獲取 |
| compete_id | string(40) | 是 | 要刪除的競爭ID |
| cascade_delete | string | 否 | 級聯(lián)刪除選項,詳情參照 級聯(lián)刪除 |
返回數(shù)據(jù)示例
{
"error_code": 0,
"error_msg": "調(diào)用成功",
"data": {
"compete_id": "xxx"
}
}
返回數(shù)據(jù)說明
| 字段 | 類型 | 字段說明 |
|---|---|---|
| compete_id | string(40) | 被刪除的競爭ID |