GetDocumentStatus - 获取文档解析状态--智能体身份和权限管理平台-火山引擎

文档中心

立即注册

智能体身份和权限管理平台

权限网关

GetDocumentStatus - 获取文档解析状态

获取文档解析状态

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

参数	类型	是否必填	示例值	描述
Action	String	是	GetDocumentStatus	要执行的操作，取值：GetDocumentStatus。
Version	String	是	2025-10-30	API的版本，取值：2025-10-30。
DocumentId	String	是	doc_123456	文档ID @example:doc_123456

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数	类型	示例值	描述
Error	String	example	错误信息（仅当 Status=failed 时有值）
Routes	Array of Object	example	解析出的路由规则列表（仅当 Status=completed 时有值）
Status	String	example	解析状态：pending-等待解析, running-解析中, completed-解析完成, failed-解析失败
CreatedAt	String	example	创建时间
FromCache	Boolean	example	是否使用了缓存
DocumentId	String	example	文档ID
CompletedAt	String	example	完成时间

请求示例

GET ?&DocumentId=doc_123456

返回示例

{
    "ResponseMetadata": {
        "Action": "GetDocumentStatus",
        "Region": "cn-north-1",
        "Service": "***",
        "Version": "2025-10-30",
        "RequestId": "20230604110420****100232280022D31"
    },
    "Result": {
        "Error": "",
        "Routes": [
            {
                "Path": "/api/v1/search",
                "Method": "POST",
                "ApiSpec": {
                    "ActionType": "READ",
                    "Extractors": [
                        {
                            "Path": "/collection_name",
                            "IsAuth": false,
                            "Source": null,
                            "ResourceType": "Collection"
                        }
                    ],
                    "ActionValue": "search",
                    "IdentifierType": null,
                    "IdentifierValue": "/collection_name",
                    "ResponseFilters": [
                        {
                            "Mode": null,
                            "IsAuth": false,
                            "IdField": "id",
                            "Attributes": [
                                {
                                    "Field": "/id",
                                    "Target": "ResourceId"
                                }
                            ],
                            "FilterPath": "/data/items",
                            "ResourcePath": "/data",
                            "ResourceType": "Collection"
                        }
                    ]
                },
                "RouteName": "SearchVectors",
                "ResourceType": "Vector",
                "PathMatchType": "Exact",
                "PermissionPool": "DefaultPool"
            }
        ],
        "Status": "",
        "CreatedAt": "",
        "FromCache": false,
        "DocumentId": "",
        "CompletedAt": ""
    }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	InvalidParameter	Invalid request parameters: %s.	参数 %s 无效
403	AccessDenied	You are not authorized to perform this action.
404	NotFound	Resource not found: %s.	资源 %s 不存在
409	Duplicated	Resource already exists: %s.	资源 %s 已存在
409	StatusConflict	Status conflict: %s.	状态冲突: %s
422	ParseFailed	Failed to parse document: %s.	文档解析失败: %s
429	QuotaExceeded	Quota exceeded: %s.	配额 %s 已达上限
500	InternalError	Internal server error: %s.	内部服务错误: %s
500	DownstreamServerError	An error has occurred due to an unreachable service.
501	NotImplemented	Not implemented: %s.	功能未实现: %s
502	UpstreamUnreachable	Upstream unreachable: %s.	后端服务 %s 不可达

最近更新时间：2025.12.14 13:43:21

这个页面对您有帮助吗？

有用

无用