列出批量操作 - Scanova API Documentation

curl "https://api.scanova.io/bulk-operation/" \
  -H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "operation_id": "bo-8f3a1c",
      "name": "September event QR batch",
      "count": 500,
      "operation_type": "generate",
      "operation_type_display": "Generate",
      "status": "completed",
      "created": "2026-09-08T09:00:00Z",
      "result_file": "https://cdn.scanova.io/bulk/bo-8f3a1c/result.xlsx",
      "progress": 100,
      "error_message": null,
      "log_file": "https://cdn.scanova.io/bulk/bo-8f3a1c/log.csv",
      "failed_count": 0,
      "folder": null,
      "created_by": "Jane Doe",
      "qr_category": "website-url"
    }
  ]
}

GET

/

bulk-operation

/

curl "https://api.scanova.io/bulk-operation/" \
  -H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "operation_id": "bo-8f3a1c",
      "name": "September event QR batch",
      "count": 500,
      "operation_type": "generate",
      "operation_type_display": "Generate",
      "status": "completed",
      "created": "2026-09-08T09:00:00Z",
      "result_file": "https://cdn.scanova.io/bulk/bo-8f3a1c/result.xlsx",
      "progress": 100,
      "error_message": null,
      "log_file": "https://cdn.scanova.io/bulk/bo-8f3a1c/log.csv",
      "failed_count": 0,
      "folder": null,
      "created_by": "Jane Doe",
      "qr_category": "website-url"
    }
  ]
}

在 Management API 主机（api.scanova.io）上列出账户批量操作的跟踪记录，使用您的原始 Management API 密钥进行身份验证。

GET https://api.scanova.io/bulk-operation/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a

curl "https://api.scanova.io/bulk-operation/" \
  -H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "operation_id": "bo-8f3a1c",
      "name": "September event QR batch",
      "count": 500,
      "operation_type": "generate",
      "operation_type_display": "Generate",
      "status": "completed",
      "created": "2026-09-08T09:00:00Z",
      "result_file": "https://cdn.scanova.io/bulk/bo-8f3a1c/result.xlsx",
      "progress": 100,
      "error_message": null,
      "log_file": "https://cdn.scanova.io/bulk/bo-8f3a1c/log.csv",
      "failed_count": 0,
      "folder": null,
      "created_by": "Jane Doe",
      "qr_category": "website-url"
    }
  ]
}

这是每个异步批量操作端点都会提示您轮询的端点。status 会从 new 变为 completed、partially_completed 或 failed；progress 是 0–100 的完成百分比。一旦 status 不再是 new，result_file 和（在相关时）log_file 就会包含下载 URL。范围：账户自己的操作，加上（对于团队账户）任何共享用户创建的操作，除非该调用是通过账户模拟身份进行的——此时范围会缩小到仅被模拟的用户。

相关内容

获取批量操作统计信息——对同一列表的汇总统计。
重命名批量操作——重命名此处的某个条目。
Management API 概览——适用于此端点的身份验证方案和配额规则。

授权

Authorization

string

header

必填

Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.

响应

200 - application/json

Paginated list of bulk operations.