算法服务统一反馈接口

一、接口描述

统一反馈接口用于收集用户对 AI 任务结果的反馈。

当前支持的任务类型：
✅ three_way_match（三单匹配）- 详见项目文档《三单匹配反馈详细说明》

支持的反馈类型：

ACCEPT（接受）：用户接受算法结果

MODIFY（修改）：用户修改算法结果

ABANDON（放弃）：用户放弃算法结果

MANUAL（人工）：用户手动匹配

接口设计特点：

通用性：通过 taskType 参数区分不同任务类型

抽象化：通用字段与任务特定数据分离

可扩展：支持后续添加新的任务类型

二、输入参数

taskType（string）：任务类型。必填字段

当前支持："three_way_match"

其他类型待扩展

feedbackType（string）：反馈类型。必填字段

可选值："ACCEPT" / "MODIFY" / "ABANDON" / "MANUAL"

clientId（string）：客户ID。必填字段

用于多租户隔离

taskId（string）：任务ID。可选字段

用于关联反馈和原始任务

ACCEPT/MODIFY/ABANDON 类型必须提供

MANUAL 类型不需要

taskData（object）：任务特定的反馈数据。必填字段

根据 taskType 和 feedbackType 而定

具体结构见对应任务类型的详细文档

三、输出参数

输出参数	类型	参数说明
errcode	string	返回码（"0000" 表示成功）
description	string	操作信息描述
data	object	扩展信息，无返回数据时为 null
traceId	string	请求唯一标识，用于追踪和关联一次请求的整个生命周期

请求参数

Query 参数

Header 参数

Body 参数application/json

示例

ACCEPT 场景输入示例MODIFY 场景输入示例ABANDON 场景输入示例MANUAL 场景输入示例

{
    "taskType": "three_way_match",
    "feedbackType": "ACCEPT",
    "clientId": "client_123",
    "taskId": "8a99a18a3ca66a8fb332c66130b09f44"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

一、接口描述#

二、输入参数#

三、输出参数#

请求参数

请求示例代码

返回响应

一、接口描述

二、输入参数

三、输出参数