如何使用 ACC API 检查 ACC 中模型的审核状态？

Question

我想使用 ACC API 检查文件或模型的审核状态。

下面我展示了一张autodesk的图片，来源：https://help.autodesk.com/view/DOCS/ENU/?guid=BIM360D_Document_Management_About_Reviews_Reviews_FAQs_Reference_html

我尝试使用

GET projects/:project_id/items/:item_id

Endpoint ，参数在下面标记为黄色，但即使审核状态在 ACC 中为“Approved”，参数“reviewStatus”也是“NOT_IN_REVIEW”。

我不知道在哪里可以找到这个状态。

Answer 1

对于给您带来的不便，我们深表歉意，但不建议使用数据管理API中返回的

reviewState

来检查文档的审核状态。此方法仅适用于 PDF 表提取状态。

相反，我们可以利用 Reviews API 的强大功能，该 API 目前处于内测阶段。请按照此博客文章加入私人测试版计划：https://aps.autodesk.com/blog/acc-reviews-api-call-beta-testing-participation

获得私人测试版访问权限后，您可以通过此 API 调用获取该信息：

curl -v 'https://developer.api.autodesk.com/construction/reviews/v1/projects/{{project_id_without_b_dot}}/versions/{{ecoded_file_version_urn}}/approval-status' \
-h 'Authorization: Bearer eyJhbGciOi...mt-uiCw'

响应示例：

{
    "results": [
        {
            "approvalStatus": {
                "id": "f44e623d-f04f-47fe-8195-efc43d1d985b",
                "label": "Approved",
                "value": "APPROVED"
            },
            "review": {
                "id": "a83b5e8e-d304-45c2-bb01-142fc22235c2",
                "sequenceId": 8,
                "status": "CLOSED"
            }
        },
    ],
    "pagination": {
        "totalResults": 1,
        "offset": 0,
        "limit": 50,
        "nextUrl": ""
    }
}

但是，我们必须调用以下API来获取评论详细信息：

curl -v 'https://developer.api.autodesk.com/construction/reviews/v1/projects/{{project_id_without_b_dot}}/reviews/{reviewId}' \
-h 'Authorization: Bearer eyJhbGciOi...mt-uiCw'