三单匹配-异步数据入库结果查询

POST

/ai/knowledge/nlpService/item/data/insert/query

一、接口描述

商品数据入库异步接口的结果查询接口

二、请求参数

请求体（JSON）字段：

taskId（string，必填）：任务的唯一标识符，用于查询该任务的入库信息。

三、主要输出参数

1.data: 输出结果。

taskId：任务唯一标识。

status：任务状态。

COMPLETED：任务已完成。可以直接获取result字段的入库信息。

PROCESSING：任务还在处理中。

FAILED：任务失败。可以查看error字段的错误原因。

taskTraceId：该任务执行时的trace_id,用于追踪该任务的执行过程

result: 数据入库信息，只有 status = COMPLETED 才会返回。

error: 任务错误原因，只有 status = FAILED 才会返回。

result参数详解：
包含以下字段：

upserted: 实际写入的商品数量（已去重）。

请求参数

Query 参数

Header 参数

Body 参数application/json

示例

{
    "taskId": "string"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST '/ai/knowledge/nlpService/item/data/insert/query?access_token={{access_token}}' \
--header 'client-platform: common' \
--header 'Content-Type: application/json' \
--data-raw '{
    "taskId": "string"
}'

返回响应

🟢200成功

application/json

Body

示例

成功示例-任务完成状态成功示例-任务处理中状态成功示例-任务失败状态失败示例-查询不存在的taskId

{
    "errcode": "0000",
    "description": "Success",
    "data": {
        "taskId": "8a99a18a3ca66a8fb332c66130b09f44",
        "status": "COMPLETED",
        "taskTraceId": "d4e5e33e57bf0237",
        "result": {
            "upserted": 2
        }
    },
    "traceId": "abf23ef9bde547789193e5338b622cad"
}

修改于 2026-04-16 03:12:05

三单匹配-异步数据入库

三单匹配反馈详细说明