# 获取静态导出作业状态 (/zh/api/static-export/get-job-status)

<!-- agent-signals: reading_time_min: 1 · est_tokens: 766 · updated: 2026-07-30 -->
Related: [启动静态导出作业](/zh/api/static-export/start-job.md), [生成导出包](/zh/api/static-export/generate-bundle.md)

<Info>
  静态导出需要 [Enterprise 套餐](https://mintlify.com/pricing?ref=static-export)。
</Info>

`GET /static-export/jobs/{jobId}`

获取静态导出任务的当前状态和进度。启动任务后，可以轮询此端点，直到 `status` 变为 `completed`（或 `failed`）。

静态导出仅适用于 Enterprise 套餐。

使用管理员 API 密钥进行身份验证。

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "parameters": [
    {
      "name": "jobId",
      "in": "path",
      "description": "由 `Start static export job` 返回的静态导出任务的 ID。",
      "required": true,
      "schema": {
        "type": "string"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "导出任务的当前状态。",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "required": [
              "jobId",
              "status",
              "progress",
              "pageCount",
              "createdAt",
              "updatedAt"
            ],
            "properties": {
              "jobId": {
                "type": "string",
                "description": "静态导出任务的唯一标识符。",
                "example": "se_3f9a2c1b8e7d4a06"
              },
              "status": {
                "type": "string",
                "description": "任务的当前状态。",
                "enum": [
                  "queued",
                  "running",
                  "completed",
                  "failed"
                ],
                "example": "running"
              },
              "progress": {
                "type": "number",
                "description": "完成百分比，范围为 0 到 100。",
                "minimum": 0,
                "maximum": 100,
                "example": 42
              },
              "pageCount": {
                "type": "integer",
                "description": "目前已导出的页面数量。",
                "example": 128
              },
              "createdAt": {
                "type": "string",
                "format": "date-time",
                "description": "任务的创建时间。"
              },
              "updatedAt": {
                "type": "string",
                "format": "date-time",
                "description": "任务的最后更新时间。"
              },
              "error": {
                "type": "string",
                "description": "人类可读的错误消息。仅当 `status` 为 `failed` 时才会出现。",
                "nullable": true
              }
            }
          }
        }
      }
    },
    "401": {
      "description": "身份验证失败。",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "人类可读的错误描述。"
              }
            }
          }
        }
      }
    },
    "404": {
      "description": "不存在使用所提供 ID 的任务。",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "人类可读的错误描述。"
              }
            }
          }
        }
      }
    }
  }
}
```