考题文档相似度分析任务状态

查询文档考题对比结果。
详情页：https://www.gugudata.com/api/details/exam-question-similarity

当前接口契约

接口详情：https://www.gugudata.com/api/details/exam-question-similarity

请求参数

参数	类型	必填	默认值	说明
operationId	string	是	无	文档提交接口返回的任务 ID，路径参数。
appkey	string	是	无	咕咕数据开发者中心分配的 APPKEY。

正常响应

HTTP 200，application/json。

字段	类型	说明
DataStatus	object	接口业务状态信息。
DataStatus.RequestParameter	string	本次请求的参数摘要。
DataStatus.StatusCode	integer	咕咕数据业务状态码，100 表示业务处理成功。
DataStatus.StatusDescription	string	业务状态说明。
DataStatus.ResponseDateTime	string	接口响应时间。
DataStatus.DataTotalCount	integer	本次响应数据总数或分页总数。
Data	object	双文档对比任务状态和终态结果。

业务状态说明

业务状态码	业务状态码解释	备注
100	正常返回	可通过判断此状态码断言接口正常返回。
-1	请求失败	请求处理失败。
501	参数错误	请检查传递的参数个数、取值范围和参数类型是否匹配。
502	请求频率受限	默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。
503	APPKEY 权限超限或订单到期	请前往开发者中心检查 APPKEY 状态与订单有效期。
504	APPKEY 错误	请检查传递的 APPKEY 是否正确。
505	请求次数超出接口限制	请检查接口剩余请求次数与配额限制。
900	接口内部响应错误	接口服务暂时不可用，请稍后重试。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。

Bodyapplication/json

示例

{
    "DataStatus": {
        "ResponseDateTime": "string",
        "DataTotalCount": 0,
        "RequestParameter": "string",
        "StatusDescription": "string",
        "StatusCode": 0
    },
    "Data": {
        "expiresAt": "2019-08-24T14:15:22.123Z",
        "operationId": "string",
        "error": {
            "message": "string",
            "statusCode": 501
        },
        "result": {
            "document1": {
                "file_name": "string",
                "extension": "string",
                "pageCount": 0,
                "charCount": 0,
                "processedCharCount": 0,
                "question_count": 0,
                "isComplete": true
            },
            "document2": {
                "file_name": "string",
                "extension": "string",
                "pageCount": 0,
                "charCount": 0,
                "processedCharCount": 0,
                "question_count": 0,
                "isComplete": true
            },
            "summary": {
                "matched_question_count": 0,
                "exact_count": 0,
                "equivalent_count": 0,
                "variant_count": 0
            },
            "matches": [
                {
                    "document1_question": "string",
                    "document2_question": "string",
                    "document1_question_id": "string",
                    "document2_question_id": "string",
                    "document1_location": "string",
                    "document2_location": "string",
                    "score": 0,
                    "duplicate_type": "exact",
                    "confidence": 0,
                    "analysis_result": "string",
                    "differences": [
                        "string"
                    ],
                    "evidence": [
                        "string"
                    ],
                    "evidence_details": [
                        {
                            "dimension": "stem_semantics",
                            "exam1": {
                                "source_type": "text",
                                "quote": "string",
                                "image_index": 1
                            },
                            "exam2": {
                                "source_type": "text",
                                "quote": "string",
                                "image_index": 1
                            },
                            "explanation": "string"
                        }
                    ]
                }
            ],
            "analysis_result": "string"
        },
        "status": "PENDING",
        "pollingUrl": "string",
        "mode": "async"
    }
}

🟠400请求参数错误。请求参数缺失、格式错误或参数组合不合法。

🟠401鉴权失败。缺少 appkey 或 appkey 无效。

🟠403无权限访问。订单到期、权限不足或接口额度不可用。

🟠404任务不存在、已过期或无权访问。

🟠405请求方法不允许。当前路径不支持该 HTTP 方法。

🟠415请求内容类型不支持。上传或请求体的内容类型不符合接口要求。

🟠429请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。

🔴500服务内部错误。服务端处理异常，请稍后重试。

🔴503考题分析服务暂时不可用，业务码 901。

考题文档相似度分析任务状态

当前接口契约#

请求参数#

正常响应#

业务状态说明#

请求参数

请求示例代码

返回响应

当前接口契约

请求参数

正常响应

业务状态说明