API Path
/aipaas/keyword/v1/sensitivewordTable/update
请求协议
HTTPS
请求方法
POST
请求头部 :
| 头部标签 | 必填 | 说明 | 类型 | 数据字典 | 限制 | 头部内容 | 示例 |
|---|---|---|---|---|---|---|---|
| Content-Type | 是 | application/json | [string] | application/json | application/json | ||
| X-APP-ID | 是 | 买家中心-已购能力-【X-APP-ID】,公网鉴权,公网调用时必传 | [string] | ||||
| Authorization | 是 | 公网鉴权,公网调用时必传 | [string] |
请求参数 Json
Object
| 参数名 | 说明 | 必填 | 类型 | 数据字典 | 限制 | 示例 |
|---|---|---|---|---|---|---|
| sensitiveWordTableId | 敏感表id | 是 | [string] | |||
| sensitiveWordDetails | 敏感列表 | 是 | [array] | ["我","你"] | ||
| appId | asr算法使用的应用id | 是 | [string] |
响应内容 :
返回结果
> 成功 (200)
> Json
> Object
| 参数名 | 说明 | 必填 | 类型 | 数据字典 | 限制 | 示例 |
|---|---|---|---|---|---|---|
| data | 是 | [object] | ||||
| data>>sensitiveWordTableId | 敏感词组id | 是 | [string] | |||
| msg | 描述信息 | 是 | [string] | 操作成功 | ||
| traceId | 日志调用链id | 否 | [string] | 46dd01d2e18740e7b7e6d7cfac98644b | ||
| code | 状态码; 1:操作成功;-1:操作失败 | 是 | [string] | 1 | ||
| success | 业务成功失败标识;false-失败,true-成功 | 是 | [boolean] | true | ||
| respCode | 响应码,990001:操作成功;990002:操作失败;990004:错误的请求参数,参考:【响应码说明】 | 否 | [string] | 990001 |
成功示例[Mock API] :
{
"code": "1",
"respCode": "990001",
"msg": "操作成功",
"data": {
"sensitiveWordTableId": "1940301508608081920"
},
"success": true
}
1.服务接口调用时需要严格遵循服务鉴权规则。
公网服务调用鉴权规则请参见:开发指南 - 接口签名认证。
{
"sensitiveWordTableId":"shdydjfhfj",
"sensitiveWordDetails":["风景很美","陕西西安"],
"appId":""
}
import java.nio.charset.StandardCharsets;
import java.io.BufferedReader;
import java.net.HttpURLConnection;
import com.fasterxml.jackson.databind.node.ArrayNode;
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.io.OutputStream;
import com.fasterxml.jackson.databind.node.ObjectNode;
import java.net.URL;
import lombok.extern.slf4j.Slf4j;
import java.io.InputStreamReader;
public class HttpPostRequestSender {
public static void sendPostRequest() {
HttpURLConnection connection = null;
try {
String url = "your_url"; // 这里替换为实际的的接口
String appId = "appid";
String appKey = "appkey";
String orderNum = "orderNum";
URL urlObj = new URL(url);
connection = ((HttpURLConnection) (urlObj.openConnection()));
connection.setRequestMethod("POST");
connection.setRequestProperty("Content-Type", "application/json");
//公网鉴权
connection.setRequestProperty("X-APP-ID", appId);
connection.setRequestProperty("Authorization", "yourAuthorization");
connection.setDoOutput(true);
ObjectMapper objectMapper = new ObjectMapper();
ObjectNode requestBody = objectMapper.createObjectNode();
requestBody.put("sensitiveWordTableId", "ssdkdifh");
requestBody.put("appId","6egdtsj7");
ArrayNode sensitiveWordDetails= objectMapper.createArrayNode();
sensitiveWordDetails.add("风景很美");
requestBody.set("sensitiveWordDetails", sensitiveWordDetails);
try (OutputStream os = connection.getOutputStream()) {
byte[] input = requestBody.toString().getBytes(StandardCharsets.UTF_8);
os.write(input, 0, input.length);
}
int responseCode = connection.getResponseCode();
if (responseCode == HttpURLConnection.HTTP_OK) {
try (BufferedReader br =
new BufferedReader(
new InputStreamReader(connection.getInputStream(), StandardCharsets.UTF_8))) {
StringBuilder response = new StringBuilder();
String responseLine;
while ((responseLine = br.readLine()) != null) {
response.append(responseLine.trim());
}
String responseString = response.toString();
JsonNode jsonResponse = objectMapper.readTree(responseString);
JsonNode data = jsonResponse.get("data");
}
} else {
System.out.println(responseCode);
}
} catch (Exception e) {
// 基本异常信息输出
System.out.println("发生异常: " + e.getMessage());
// 打印完整堆栈跟踪
e.printStackTrace();
} finally {
if (connection != null) {
connection.disconnect();
}
}
}
public static void main(String[] args) {
sendPostRequest();
}
}
import json
import requests
def send_post_request():
"""
发送POST请求到热词检测接口(同步简单版本)
"""
try:
# 配置参数
url = "https://xx" # 这里替换为实际的接口
app_id = "xx"
authorization = "xx"
# 构建请求头
headers = {
"Content-Type": "application/json",
"X-APP-ID": app_id,
"Authorization": authorization
}
# 构建请求体
request_body = {
"hotWordTableId": "ssdkdifh",
"appId": "ssdkdifh",
"hotWordDetails": ["风景很美"]
}
# 发送POST请求
response = requests.post(
url=url,
headers=headers,
json=request_body,
timeout=30
)
# 处理响应
if response.status_code == 200:
response_data = response.json()
print(f"response_data{response_data}")
return response_data
else:
print(f"POST请求失败,状态码: {response.status_code}")
return None
except Exception as e:
print(f"请求异常: {e}")
return None
# 使用示例
if __name__ == "__main__":
result = send_post_request()
if result is not None:
print("请求成功")
else:
print("请求失败")
| 响应code | 响应信息 | |
|---|---|---|
| 990001 | 成功 | 操作成功 |
| 990002 | 失败 | 操作失败 |
| 010401 | 失败 | 该应用不存在 |
| 010410 | 失败 | 插入敏感词详情失败 |
| 010411 | 失败 | 敏感词表不能包含标点和特殊字符,且最多支持64个字符 |
| 010412 | 失败 | 敏感词不能少于1个或者不能大于50个字符,且敏感词不能包含标点、阿拉伯数字和特殊字符 |
| 010413 | 失败 | 该应用下创建超过30个敏感词表 |
| 010414 | 失败 | 该敏感表下超过5000个敏感词 |
| 010415 | 失败 | 该应用不存在该敏感词组 |
| 010416 | 失败 | 该应用与敏感词组id不匹配或未查询到敏感词 |