三单匹配-异步数据入库
开发中
POST
/ai/knowledge/nlpService/item/data/insert
一、接口描述
client_id + product_code 相同时：callbackUrl 进行回调通知。⚠️ 注意事项
二、请求参数
1. 输入参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| callbackUrl | String | 是 | 异步任务完成后的回调地址（HTTP POST） |
| items | Array | 是 | 商品数据列表，最多 500 条 |
2. 单条商品数据结构（Item Object）
| 字段名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| client_id | String | 是 | 租户标识 |
| product_code | String | 是 | 商品编码（唯一标识） |
| product_name | String | 是 | 商品名称 |
| specification_model | String | 否 | 规格型号（可为空字符串或不传） |
📌 请求示例
{
"callbackUrl": "https://example.com/callback",
"items": [
{
"client_id": "C1001",
"product_code": "P001",
"product_name": "螺丝",
"specification_model": "M3*10"
},
{
"client_id": "C1001",
"product_code": "P002",
"product_name": "螺母",
"specification_model": ""
}
]
}三、响应参数（同步返回）
| 参数名 | 类型 | 是否必返 | 说明 |
|---|---|---|---|
| errcode | String | 是 | 返回码（"0000" 表示提交成功） |
| description | String | 是 | 操作信息描述 |
| data | Object | 是 | 返回数据 |
| data.taskId | String | 是 | 异步任务唯一标识 |
| traceId | String | 是 | 请求唯一标识（用于链路追踪） |
四、回调参数（异步通知）
callbackUrl 发送 POST 请求：回调字段说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| errcode | String | 返回码（"0000" 表示成功） |
| description | String | 描述信息（如去重数量等） |
| data | Object | 成功时返回，失败为 null |
| data.taskId | String | 任务唯一标识 |
| data.upserted | Integer | 实际写入数量（去重后） |
| traceId | String | 请求唯一标识 |
📌 回调示例
{
"errcode": "0000",
"description": "Success, 1 duplicate product_code(s) were deduplicated",
"data": {
"taskId": "ec6fa3c4-f1a3-43b1-bde4-d13552dee144",
"upserted": 488
},
"traceId": "abf23ef9bde547789193e5338b622cad"
}请求参数
Query 参数
Header 参数
Body 参数application/json
请求示例代码
返回响应
修改于 2026-04-13 08:04:19