在数字化时代，二维码的应用场景越来越广泛。Artistic QR Tasks API 允许开发者通过输入任务 ID 来查询任务的执行状态，极大地方便了对二维码生成任务的管理。本文将详细介绍如何集成和使用 Artistic QR Tasks API，帮助您充分发挥其强大功能。
背景
Ace Data Cloud 是一个强大的数据服务平台，提供多种 API，包括二维码生成和管理服务。Artistic QR Tasks API 主要用于查询通过 Artistic QR Generation API 创建的二维码任务的状态。使用这个 API，您可以轻松获取任务的执行结果，适用于多种业务场景，如营销活动、产品推广等。
申请流程
要使用 Artistic QR Tasks API，您首先需要在 Artistic QR Generation API 页面申请服务，并复制由该 API 生成的任务 ID，如下图所示：
接着，访问 Artistic QR Tasks API 页面申请相应服务。进入页面后，点击“获取”按钮，如下图所示：
如果您未登录或未注册，将会自动跳转到 登录页面，在注册或登录后，您将自动返回当前页面。首次申请可以享受免费的配额，允许您免费使用此 API。
请求示例
Artistic QR Tasks API 可用于查询二维码生成任务的结果。假设我们有一个任务 ID：e2c65b20-a970-431e-99c1-76721e799df8，以下是如何使用该 API 的示例。
设置请求头与请求体
请求头 包括：
accept: 指定响应格式为 JSON，设置为application/json。authorization: 调用 API 的密钥，在申请后可直接获得。
请求体 包括：
id: 上传的任务 ID。action: 任务的操作方法。
设置方式如下图所示：
代码示例
系统会自动生成多种语言的代码示例，以下是 CURL 和 Python 的示例：
CURL
curl -X POST 'https://api.acedata.cloud/qrart/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
"id": "e2c65b20-a970-431e-99c1-76721e799df8",
"action": "retrieve"
}'
Python
import requests
url = "https://api.acedata.cloud/qrart/tasks"
headers = {
"accept": "application/json",
"authorization": "Bearer {token}",
"content-type": "application/json"
}
payload = {
"id": "e2c65b20-a970-431e-99c1-76721e799df8",
"action": "retrieve"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)
响应示例
成功请求后，API 将返回二维码任务的详细信息，例如：
{
"_id": "668cb62c550a4144a582e372",
"id": "e2c65b20-a970-431e-99c1-76721e799df8",
"application_id": "3d25be99-4676-44d3-90bb-23086bc25300",
"created_at": 1720497708.318,
"credential_id": "6e80fca1-9a49-4507-ae8e-601dbd0ab3ca",
"request": {
"aspect_ratio": "1:1",
"content": "https://platform.acedata.cloud",
"ecl": "H",
"marker_shape": "square",
"prompt": "mexican tacos",
"qrw": 2,
"steps": 20,
"type": "link"
},
"response": {
"image_url": "https://platform.cdn.acedata.cloud/qrart/e2c65b20-a970-431e-99c1-76721e799df8.png",
"image_width": 768,
"image_height": 768,
"success": true
}
}
返回结果包含多个字段，其中 request 字段为任务发起时的请求体，而 response 字段为任务完成后的响应体。
批量查询操作
若需查询多个二维码任务的详情，您可以选择批量查询，操作方法为 retrieve_batch。
请求体 包括：
ids: 上传的任务 ID 数组。action: 任务的操作方法。
代码示例
CURL
curl -X POST 'https://api.acedata.cloud/qrart/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
"ids": ["8c89e97b-6a79-4406-b2ce-e00f92540b4e","e2c65b20-a970-431e-99c1-76721e799df8"],
"action": "retrieve_batch"
}'
Python
import requests
url = "https://api.acedata.cloud/qrart/tasks"
headers = {
"accept": "application/json",
"authorization": "Bearer {token}",
"content-type": "application/json"
}
payload = {
"ids": ["8c89e97b-6a79-4406-b2ce-e00f92540b4e","e2c65b20-a970-431e-99c1-76721e799df8"],
"action": "retrieve_batch"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)
错误处理
调用 API 时，如果发生错误，API 将返回相应的错误代码和消息，例如：
400 token_mismatched: 请求错误，可能由于缺少或无效参数。401 invalid_token: 未授权，授权令牌无效或缺失。429 too_many_requests: 请求过多，超出了速率限制。
错误响应示例
{
"success": false,
"error": {
"code": "api_error",
"message": "fetch failed"
},
"trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}
总结
通过本文的介绍，您已经了解了如何使用 Artistic QR Tasks API 查询单个或批量二维码任务的详细信息。希望这些内容能帮助您更好地集成和使用该 API。如有任何疑问，请随时联系技术支持团队。
技术标签：#二维码 #API #数据服务 #开发者工具 #AceDataCloud
