# 离线解析模拟交付记录


这是为准备解析器的 Developer 提供的离线模拟练习。所有标识和值都是虚构的，结构采用已记录的重放响应格式。练习不连接 Humanbased，不需要账号或 Key，不移动读取位置，也不产生费用。

## 1. 运行本地解析器

需要 Python 3，以及支持引号 heredoc 的终端（bash 或 zsh）。完整复制下方代码；示例从内存读取模拟响应，不写文件。

```sh
python3 - <<'PY'
import json

page = json.loads(r'''{
  "data": {
    "items": [
      {
        "submission_id": "784210006031",
        "task_id": "784210005001",
        "campaign_id": "784210001001",
        "template_id": "784210002001",
        "data": {
          "case_id": "returns-014",
          "decision": "escalate"
        },
        "quality_score": 0.85,
        "quality_grade": "A",
        "unit_price_usd": 0.02,
        "source": "web",
        "created_at": "2026-10-01T09:30:00+00:00"
      }
    ],
    "next_cursor": null,
    "has_more": false,
    "count": 1,
    "receipt": null
  },
  "success": true,
  "errorCode": 0,
  "errorMessage": "SUCCESS"
}''')
assert page["success"] is True and page["errorCode"] == 0
items = page["data"]["items"]
assert page["data"]["count"] == len(items)
for record in items:
    assert isinstance(record["submission_id"], str)
    print(record["submission_id"], record["data"]["case_id"], record["data"]["decision"])
print("count:", len(items), "has_more:", page["data"]["has_more"])
PY
```

```text
784210006031 returns-014 escalate
count: 1 has_more: False
```

## 2. 解释输出

`data.items` 中是交付记录；每条记录的 `data` 已是 JSON 对象，不要再次解码。标识保持字符串。本例只有一条、没有下一页；真实响应可能为空或需要翻页。

`receipt: null` 表示这次重放没有新增扣款，不代表底层记录免费。本地解析成功不能证明已取得线上访问权或数据使用权。

找不到 Python 时先安装 Python 3。断言或语法错误表示复制的程序或模拟数据有差异，重新复制完整代码并检查报错行；这不是正式 API 错误。

## 3. 接入已授权数据

准备组织、符合条件的订阅、使用许可与匹配的 Key，再按[首次获取已授权数据](/zh/api/api-data)操作。对照[交付接口参考](/zh/api/api-fields)处理真实空页、游标、错误和费用，不要把本例虚构标识带入正式请求。
