主题
创建/修改栏目
用于创建或修改新闻栏目
接口说明
请求URL:http[s]://{网关地址}/casp-ia/v2/saveColumn
请求方式: POST
请求内容类型: application/json
响应内容类型: application/json
请求说明
请求体
| 字段名 | 参数名 | 必填 | 类型 | 描述 |
|---|---|---|---|---|
| 新闻栏目主键 | wid | O | String(64) | 可使用英文、数字、下划线组成,长度小于64位 为空:新增栏目 不为空:编辑栏目 |
| 新闻栏目名称 | name | M | List<MultiLang> | 栏目名称(支持多语言),中文名称必填 |
| 所属新闻站点主键 | newsSiteWid | M | String(64) | 可使用英文、数字、下划线组成,长度小于64位 栏目所属新闻站点wid |
| 字段名 | 参数名称 | 必填 | 类型 | 描述 |
|---|---|---|---|---|
| 多语言国家 | langKey | M | String | 多语言国家(中文:zh_CN,英文:en) |
| 多语言值 | langValue | M | String(240) | 中文:长度不超过20 英文:长度不超过120 其它:长度不超过240 |
请求示例
json
{
"name":[
{"langKey":"zh_CN","langValue":"栏目名称"}
],
"newsSiteWid":"1001521276508270592"
}1
2
3
4
5
6
2
3
4
5
6
响应说明
响应体
| 参数名 | 类型 | 描述 |
|---|---|---|
| errcode | String | 返回码 |
| errmsg | String | 返回描述 |
| data | NewsColumn | 返回的新闻站点对象 |
| 字段名 | 参数名称 | 类型 | 描述 |
|---|---|---|---|
| 新闻栏目主键 | columnWid | String | 新闻栏目主键 |
| 所属新闻站点主键 | newsSiteWid | String | 所属新闻站点主键 |
| 新闻栏目名称 | columnName | List<MultiLang> | 新闻栏目名称 |
| 栏目是否自动刷新 | isAutoRefresh | integer | 栏目是否自动刷新 |
| 栏目类型 | type | String | 栏目类型 |
响应示例
json
{
"errcode": "0",
"errmsg": "success",
"data": {
"columnWid": "1005164313423736833",
"newsSiteWid": "1001521276508270592",
"columnName": [
{
"langValue": "栏目名称",
"langKey": "zh_CN"
}
],
"isAutoRefresh": 0,
"type": "外部数据库"
}
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
错误码
| 错误码 | 描述 |
|---|---|
| 331005 | 栏目名称长度超过限定值 |
| 334002 | 无权限在站点下创建/修改栏目 |
| 334004 | 不可在非接口创建站点下创建栏目 |
| 336005 | 栏目所属新闻站点不存在 |
| 336006 | 同站点下已有同名栏目 |
| 999 | 统一错误码,详细描述信息参见接口返回 |
Demo
java
// 创建客户端
Client client = new DefaultClient(BASE_URL, APP_ID, APP_SECRET);
// 创建请求对象
SaveColumnRequest request = new SaveColumnRequest();
request.setWid("");
request.setName(Arrays.asList(new NewsMultiLang(LangCountryType.ZH_CN, "栏目名称")));
request.setNewsSiteWid("1001521276508270592");
SaveColumnResponse response = client.execute(request);
//调用成功,则处理业务逻辑
if (response.isSuccess()) {
//.....
}1
2
3
4
5
6
7
8
9
10
11
12
2
3
4
5
6
7
8
9
10
11
12

