Skip to content

Get a single record

Fetches one record by ID or URL. Supports json, json-ld, and markdown.

This page focuses on response structure and integration notes; full schemas and demos live in the companion folder. Example files are sanitized.

Request example

python
import requests

url = 'https://open.cli.im/api/v2/rpc/record/getRecord'
data = {
    'record_id': 10001,
    'format': 'json'
}
headers = {
    'Authorization': 'Bearer <your API Key>',
    'Content-Type': 'application/json'
}
response = requests.post(url, json=data, headers=headers)
print(response.text)
bash
curl -X POST 'https://open.cli.im/api/v2/rpc/record/getRecord' \
  -H 'Authorization: Bearer <your API Key>' \
  -H 'Content-Type: application/json' \
  -d '{"record_id": 10001, "format": "json"}'

Request parameters

ParameterTypeRequiredDescription
record_idintegerNoRecord ID. Provide either this or record_url; at least one is required
record_urlstringNoShort record URL, typically the full access URL starting with the record code r. Provide either this or record_id; at least one is required
formatstringNoOutput format, default json. Values: json, json-ld, markdown

Output format overview

formatdata.content_typedata.data typeTypical use
jsonapplication/json; charset=utf-8objectProgrammatic parsing, field-level processing, data sync
json-ldapplication/ld+json; charset=utf-8objectSemantic data exchange, Schema.org style integration
markdowntext/markdown; charset=utf-8stringReading, archive export, summarization

The code blocks below show the response skeleton for each format.

json
{
  "code": 0,
  "message": "ok",
  "data": {
    "format": "json",
    "content_type": "application/json; charset=utf-8",
    "data": {
      "record_id": 10001,
      "record_number": "REC-001",
      "record_code": "record_demo_code_001",
      "record_url": "https://example.com/records/record-demo-001",
      "submit_at": 1773056539,
      "submit_at_iso": "2026-03-09 19:42:19(UTC+08:00)",
      "submit_method": "扫一扫填写",
      "recorder": { "auth_id": 20001, "user_id": 30001, "name": "张**" },
      "project": { "id": 40001, "name": "示例园区", "number": "P001" },
      "qrcode": { "id": 50001, "name": "示例点位A", "type": 0, "type_text": "普通二维码", "template_id": 50010, "qrcode_url": "https://example.com/qrcodes/qrcode-demo-001", "number": "", "category_id": 50020 },
      "org": { "id": 60001, "name": "示例企业", "code": "org_demo_code", "logo_url": "https://example.com/assets/logo-demo.png" },
      "record_template": { "id": 70001, "name": "设备巡检示例", "type": 0, "type_text": "普通表单", "number": "TPL-001" },
      "audit": { "enabled": true, "current_stage_id": 80001, "current_stage_title": "组长审批", "status": 0, "status_text": "待审核", "auditor_name": "李**" },
      "process_status": { "enabled": true, "text": "处理中", "color": "#155EB7" },
      "state_changes": [],
      "trusted_notary": { "tx_hash": "a1b2c3d4...", "evidence_url": "https://example.com/notary/...", "notarized_at": 1775539953, "notarized_at_iso": "2026-04-07 13:32:33(UTC+08:00)" },
      "tpl_groups": [ { "...": "See example files and schema for full field structure" } ]
    }
  }
}
json
{
  "code": 0,
  "message": "ok",
  "data": {
    "format": "json-ld",
    "content_type": "application/ld+json; charset=utf-8",
    "data": {
      "@context": "https://schema.org",
      "@type": "CreativeWork",
      "identifier": "record-demo-001",
      "name": "设备巡检示例-REC-001",
      "url": "https://example.com/records/record-demo-001",
      "mainEntity": { "@type": "ItemList", "name": "组件数据" }
    }
  }
}
json
{
  "code": 0,
  "message": "ok",
  "data": {
    "format": "markdown",
    "content_type": "text/markdown; charset=utf-8",
    "data": "---\ntitle: 设备巡检示例-REC-001\nrecord_id: 10001\n...\n---\n\n# 设备巡检示例-REC-001\n\n## 基本信息\n\n**记录编号:** REC-001"
  }
}

Response structure overview

response.schema.json (full API response schema)
json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "response.schema.json",
  "title": "record/getRecord response schema",
  "description": "`record/getRecord` 的完整响应结构,包含成功响应(json/json-ld/markdown)和错误响应。",
  "oneOf": [
    {
      "$ref": "#/$defs/SuccessJson"
    },
    {
      "$ref": "#/$defs/SuccessJsonLd"
    },
    {
      "$ref": "#/$defs/SuccessMarkdown"
    },
    {
      "$ref": "#/$defs/ErrorResponse"
    }
  ],
  "$defs": {
    "SuccessBase": {
      "type": "object",
      "required": [
        "code",
        "message",
        "data"
      ],
      "properties": {
        "code": {
          "type": "integer",
          "const": 0
        },
        "message": {
          "type": "string"
        }
      },
      "additionalProperties": false
    },
    "SuccessJson": {
      "allOf": [
        {
          "$ref": "#/$defs/SuccessBase"
        },
        {
          "type": "object",
          "properties": {
            "data": {
              "type": "object",
              "required": [
                "format",
                "content_type",
                "data"
              ],
              "properties": {
                "format": {
                  "type": "string",
                  "const": "json"
                },
                "content_type": {
                  "type": "string",
                  "const": "application/json; charset=utf-8"
                },
                "data": {
                  "$ref": "content-json.schema.json"
                }
              },
              "additionalProperties": false
            }
          },
          "additionalProperties": false
        }
      ]
    },
    "SuccessJsonLd": {
      "allOf": [
        {
          "$ref": "#/$defs/SuccessBase"
        },
        {
          "type": "object",
          "properties": {
            "data": {
              "type": "object",
              "required": [
                "format",
                "content_type",
                "data"
              ],
              "properties": {
                "format": {
                  "type": "string",
                  "const": "json-ld"
                },
                "content_type": {
                  "type": "string",
                  "const": "application/ld+json; charset=utf-8"
                },
                "data": {
                  "$ref": "content-jsonld.schema.json"
                }
              },
              "additionalProperties": false
            }
          },
          "additionalProperties": false
        }
      ]
    },
    "SuccessMarkdown": {
      "allOf": [
        {
          "$ref": "#/$defs/SuccessBase"
        },
        {
          "type": "object",
          "properties": {
            "data": {
              "type": "object",
              "required": [
                "format",
                "content_type",
                "data"
              ],
              "properties": {
                "format": {
                  "type": "string",
                  "const": "markdown"
                },
                "content_type": {
                  "type": "string",
                  "const": "text/markdown; charset=utf-8"
                },
                "data": {
                  "$ref": "content-markdown.schema.json"
                }
              },
              "additionalProperties": false
            }
          },
          "additionalProperties": false
        }
      ]
    },
    "ErrorResponse": {
      "type": "object",
      "required": [
        "code",
        "error_code",
        "message",
        "message_detail"
      ],
      "properties": {
        "code": {
          "type": "integer"
        },
        "error_code": {
          "type": "integer"
        },
        "message": {
          "type": "string"
        },
        "message_detail": {
          "type": "string"
        }
      },
      "additionalProperties": false
    }
  }
}
PathTypeDescription
codeintegerPlatform status code; 0 means success
messagestringStatus message
dataobjectUnified business wrapper
data.formatstringActual return format, corresponds to the format in the request
data.content_typestringMIME type of the business payload
data.dataobject | stringBusiness payload; actual type depends on data.format

Wrapper example:

json
{
  "format": "json",
  "content_type": "application/json; charset=utf-8",
  "data": { "...": "..." }
}

format=json details

When format=json, data.data is a structured record object. Full payload schema and examples are in the collapsible sections below.

content-json.schema.json (payload schema)
json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "content-json.schema.json",
  "title": "record/getRecord content schema (format=json)",
  "description": "`record/getRecord` 在 `format=json` 时 `data.data` 的结构定义。用于说明记录详情对象本体,不含最外层 code/message/data 包装。",
  "type": "object",
  "required": [
    "record_id",
    "record_number",
    "record_code",
    "record_url",
    "submit_at",
    "submit_at_iso",
    "submit_method",
    "tpl_groups",
    "recorder",
    "qrcode",
    "org",
    "record_template"
  ],
  "properties": {
    "record_id": {
      "type": "integer",
      "description": "记录ID(企业下唯一)"
    },
    "record_number": {
      "type": "string",
      "description": "记录编号(企业内唯一)"
    },
    "record_code": {
      "type": "string",
      "description": "记录code(平台唯一)"
    },
    "record_url": {
      "type": "string",
      "format": "uri",
      "description": "记录码访问地址(平台唯一)"
    },
    "submit_at": {
      "type": "integer",
      "description": "记录提交时间(Unix 时间戳,秒)"
    },
    "submit_at_iso": {
      "type": "string",
      "description": "记录提交时间(格式:Y-m-d H:i:s(UTC+08:00))"
    },
    "submit_method": {
      "type": "string",
      "description": "记录填写方式,如\"扫一扫填写\"\"手动添加\"等"
    },
    "recorder": {
      "$ref": "#/$defs/Recorder"
    },
    "tpl_groups": {
      "type": "array",
      "description": "模板分组列表,每个分组包含若干字段",
      "items": {
        "$ref": "#/$defs/TplGroup"
      }
    },
    "project": {
      "$ref": "#/$defs/Project"
    },
    "qrcode": {
      "$ref": "#/$defs/Qrcode"
    },
    "org": {
      "$ref": "#/$defs/Org"
    },
    "record_template": {
      "$ref": "#/$defs/RecordTemplate"
    },
    "audit": {
      "$ref": "#/$defs/Audit"
    },
    "process_status": {
      "$ref": "#/$defs/ProcessStatus"
    },
    "state_changes": {
      "type": "array",
      "description": "状态变更记录列表",
      "items": {
        "$ref": "#/$defs/StateChange"
      }
    }
  },
  "additionalProperties": false,
  "$defs": {
    "Recorder": {
      "type": "object",
      "description": "记录提交人信息",
      "required": [
        "auth_id",
        "user_id",
        "name"
      ],
      "properties": {
        "auth_id": {
          "type": "integer",
          "description": "提交人权限ID"
        },
        "user_id": {
          "type": "integer",
          "description": "提交人用户ID"
        },
        "name": {
          "type": "string",
          "description": "提交人姓名"
        }
      },
      "additionalProperties": false
    },
    "Project": {
      "type": "object",
      "description": "所属项目信息",
      "required": [
        "id",
        "name",
        "number"
      ],
      "properties": {
        "id": {
          "type": "integer",
          "description": "项目ID"
        },
        "name": {
          "type": "string",
          "description": "项目名称"
        },
        "number": {
          "type": "string",
          "description": "项目编号"
        }
      },
      "additionalProperties": false
    },
    "Qrcode": {
      "type": "object",
      "description": "关联二维码信息",
      "required": [
        "id",
        "name",
        "type",
        "type_text",
        "template_id",
        "qrcode_url",
        "number"
      ],
      "properties": {
        "id": {
          "type": "integer",
          "description": "二维码ID"
        },
        "name": {
          "type": "string",
          "description": "二维码名称"
        },
        "type": {
          "type": "integer",
          "description": "二维码类型(0=普通二维码)"
        },
        "type_text": {
          "type": "string",
          "description": "二维码类型文本"
        },
        "template_id": {
          "type": "integer",
          "description": "二维码模板ID"
        },
        "qrcode_url": {
          "type": "string",
          "format": "uri",
          "description": "二维码短链接地址"
        },
        "number": {
          "type": "string",
          "description": "二维码编号"
        },
        "category_id": {
          "type": [
            "integer",
            "null"
          ],
          "description": "目录ID"
        }
      },
      "additionalProperties": false
    },
    "Org": {
      "type": "object",
      "description": "所属组织/企业信息",
      "required": [
        "id",
        "name",
        "code",
        "logo_url"
      ],
      "properties": {
        "id": {
          "type": "integer",
          "description": "企业ID(平台唯一)"
        },
        "name": {
          "type": "string",
          "description": "企业名称"
        },
        "code": {
          "type": "string",
          "description": "企业唯一编码"
        },
        "logo_url": {
          "type": "string",
          "format": "uri",
          "description": "企业Logo URL"
        }
      },
      "additionalProperties": false
    },
    "RecordTemplate": {
      "type": "object",
      "description": "记录模板(表单)信息",
      "required": [
        "id",
        "name",
        "type",
        "type_text",
        "number"
      ],
      "properties": {
        "id": {
          "type": [
            "integer",
            "null"
          ],
          "description": "表单ID"
        },
        "name": {
          "type": [
            "string",
            "null"
          ],
          "description": "表单名称"
        },
        "type": {
          "type": [
            "integer",
            "null"
          ],
          "description": "表单类型:0/1/2=普通表单, 3=保密承诺系统表单, 7=码状态手动变更记录系统表单, 12=身份组成员申请加入记录表单, 13=子码编辑记录系统表单, 21=码留言记录系统表单, 22=码协作记录系统表单",
          "enum": [
            null,
            0,
            1,
            2,
            3,
            7,
            12,
            13,
            21,
            22
          ]
        },
        "type_text": {
          "type": [
            "string",
            "null"
          ],
          "description": "表单类型说明"
        },
        "number": {
          "type": [
            "string",
            "null"
          ],
          "description": "表单编号"
        }
      },
      "additionalProperties": false
    },
    "Audit": {
      "type": "object",
      "description": "当前审核阶段信息(仅在启用审核时出现)",
      "required": [
        "enabled"
      ],
      "properties": {
        "enabled": {
          "type": "boolean",
          "description": "是否启用审核"
        },
        "current_stage_id": {
          "type": [
            "integer",
            "null"
          ],
          "description": "当前审核阶段ID"
        },
        "current_stage_title": {
          "type": [
            "string",
            "null"
          ],
          "description": "当前审核阶段名称"
        },
        "status": {
          "type": [
            "integer",
            "null"
          ],
          "description": "审核状态码(0=待审核, 1=审核通过, 2=审核拒绝)"
        },
        "status_text": {
          "type": [
            "string",
            "null"
          ],
          "description": "审核状态文本"
        },
        "auditor_name": {
          "type": [
            "string",
            "null"
          ],
          "description": "审核人姓名"
        }
      },
      "additionalProperties": false
    },
    "ProcessStatus": {
      "type": "object",
      "description": "处理状态信息(仅在启用处理状态时出现)",
      "required": [
        "enabled"
      ],
      "properties": {
        "enabled": {
          "type": "boolean",
          "description": "是否启用处理状态"
        },
        "text": {
          "type": [
            "string",
            "null"
          ],
          "description": "当前处理状态文本"
        },
        "color": {
          "type": [
            "string",
            "null"
          ],
          "description": "状态颜色(Hex 格式,如 #155EB7)"
        }
      },
      "additionalProperties": false
    },
    "StateChange": {
      "type": "object",
      "description": "单条状态变更记录",
      "required": [
        "state",
        "from_state_option",
        "to_state_option"
      ],
      "properties": {
        "state": {
          "type": "object",
          "description": "状态定义",
          "required": [
            "id",
            "name",
            "number"
          ],
          "properties": {
            "id": {
              "type": "integer",
              "description": "状态ID"
            },
            "name": {
              "type": "string",
              "description": "状态名称"
            },
            "number": {
              "type": "string",
              "description": "状态编号"
            }
          },
          "additionalProperties": false
        },
        "from_state_option": {
          "$ref": "#/$defs/StateOption"
        },
        "to_state_option": {
          "$ref": "#/$defs/StateOption"
        }
      },
      "additionalProperties": false
    },
    "StateOption": {
      "type": "object",
      "description": "状态选项值",
      "required": [
        "name",
        "color"
      ],
      "properties": {
        "name": {
          "type": "string",
          "description": "状态选项名称"
        },
        "color": {
          "type": "string",
          "description": "状态选项颜色(Hex 格式)"
        }
      },
      "additionalProperties": false
    },
    "TplGroup": {
      "type": "object",
      "description": "模板分组",
      "required": [
        "group_id",
        "group_title",
        "show_group_title",
        "is_page_break_group",
        "fields"
      ],
      "properties": {
        "group_id": {
          "type": "integer",
          "description": "分组ID"
        },
        "group_title": {
          "type": "string",
          "description": "分组标题(空字符串表示无标题)"
        },
        "show_group_title": {
          "type": "boolean",
          "description": "是否显示分组标题"
        },
        "is_page_break_group": {
          "type": "boolean",
          "description": "是否为分页标记组(分页组的 fields 通常为空数组)"
        },
        "fields": {
          "type": "array",
          "description": "分组内的字段列表",
          "items": {
            "$ref": "#/$defs/Field"
          }
        }
      },
      "additionalProperties": false
    },
    "Field": {
      "type": "object",
      "description": "单个表单字段",
      "required": [
        "field_id",
        "field_title",
        "field_type",
        "field_value",
        "options"
      ],
      "properties": {
        "field_id": {
          "type": "integer",
          "description": "字段ID"
        },
        "field_title": {
          "type": "string",
          "description": "字段标题"
        },
        "field_desc": {
          "type": "string",
          "description": "字段描述/提示文字"
        },
        "field_type": {
          "type": "string",
          "description": "字段类型标识",
          "enum": [
            "name",
            "tel",
            "recorder",
            "identity",
            "job_number",
            "text",
            "textarea",
            "date",
            "time",
            "customer_name",
            "customer_mobile",
            "customer_number",
            "carnumber",
            "sex",
            "radio",
            "number",
            "checkbox",
            "checklist",
            "matrix",
            "dynamic_matrix",
            "address",
            "owner_address",
            "chained_selects",
            "image",
            "signature",
            "audio",
            "video",
            "file",
            "description",
            "ocr_id_card",
            "ocr_bank_card",
            "ocr_vehicle_license",
            "ocr_driving_license",
            "ocr_car_number",
            "ocr_car_vin",
            "ocr_business_license",
            "ocr_way_bill",
            "ocr_special_operate",
            "ocr_general_cert",
            "ocr_degree_cert",
            "ocr_diploma_cert",
            "ocr_dashboard_mile",
            "ocr_electric_meter",
            "ocr_water_meter",
            "ocr_hygrother_mograp",
            "ocr_gas_meter",
            "ocr_pressure_meter",
            "ocr_general_meter",
            "ocr_digital_meter",
            "ocr_roll_meter",
            "ocr_pointer_meter",
            "ocr_liquid_column_meter",
            "sub_qrcode_edit_diff"
          ]
        },
        "field_short_name": {
          "type": "string",
          "description": "字段短名称"
        },
        "group_id": {
          "type": "integer",
          "description": "所属分组ID"
        },
        "field_value": {
          "description": "字段值,类型随 field_type 不同而变化,详见 $defs/FieldValue*",
          "oneOf": [
            {
              "$ref": "#/$defs/FieldValueString"
            },
            {
              "$ref": "#/$defs/FieldValueSingleOption"
            },
            {
              "$ref": "#/$defs/FieldValueNumber"
            },
            {
              "$ref": "#/$defs/FieldValueCheckbox"
            },
            {
              "$ref": "#/$defs/FieldValueChecklist"
            },
            {
              "$ref": "#/$defs/FieldValueMatrix"
            },
            {
              "$ref": "#/$defs/FieldValueDynamicMatrix"
            },
            {
              "$ref": "#/$defs/FieldValueAddress"
            },
            {
              "$ref": "#/$defs/FieldValueOwnerAddress"
            },
            {
              "$ref": "#/$defs/FieldValueChainedSelects"
            },
            {
              "$ref": "#/$defs/FieldValueImageList"
            },
            {
              "$ref": "#/$defs/FieldValueAudioList"
            },
            {
              "$ref": "#/$defs/FieldValueVideoList"
            },
            {
              "$ref": "#/$defs/FieldValueFileList"
            },
            {
              "$ref": "#/$defs/FieldValueDescription"
            },
            {
              "$ref": "#/$defs/FieldValueOcr"
            },
            {
              "$ref": "#/$defs/FieldValueSubQrcodeEditChangeList"
            }
          ]
        },
        "options": {
          "$ref": "#/$defs/FieldOptions"
        }
      },
      "additionalProperties": false
    },
    "FieldOptions": {
      "type": "object",
      "description": "字段显示选项",
      "required": [
        "is_result",
        "is_highlight",
        "is_hidden",
        "is_masked"
      ],
      "properties": {
        "is_result": {
          "type": "boolean",
          "description": "是否为结果字段"
        },
        "is_highlight": {
          "type": "boolean",
          "description": "是否高亮显示"
        },
        "is_hidden": {
          "type": "boolean",
          "description": "是否隐藏"
        },
        "is_masked": {
          "type": "boolean",
          "description": "是否脱敏显示"
        }
      },
      "additionalProperties": false
    },
    "FieldValueString": {
      "type": "string",
      "description": "纯文本字段值。适用 field_type: name, tel, recorder, identity, job_number, text, textarea, date, time, customer_name, customer_mobile, customer_number, carnumber"
    },
    "FieldValueSingleOption": {
      "type": "object",
      "description": "单选字段值。适用 field_type: sex, radio",
      "required": [
        "option_text",
        "option_id"
      ],
      "properties": {
        "option_text": {
          "type": "string",
          "description": "选项文本。若选择\"其他\"并填写补充,格式为 \"其他[补充内容]\""
        },
        "option_id": {
          "type": "integer",
          "description": "选项ID"
        }
      },
      "additionalProperties": false
    },
    "FieldValueNumber": {
      "type": "object",
      "description": "数字字段值。适用 field_type: number",
      "required": [
        "value",
        "unit",
        "unit_enabled"
      ],
      "properties": {
        "value": {
          "type": "number",
          "description": "数值"
        },
        "unit": {
          "type": "string",
          "description": "单位文本(无单位时为空字符串)"
        },
        "unit_enabled": {
          "type": "boolean",
          "description": "是否启用单位"
        }
      },
      "additionalProperties": false
    },
    "FieldValueCheckbox": {
      "type": "object",
      "description": "多选字段值。适用 field_type: checkbox",
      "required": [
        "values"
      ],
      "properties": {
        "values": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "option_id",
              "option_text"
            ],
            "properties": {
              "option_id": {
                "type": "integer",
                "description": "选项ID"
              },
              "option_text": {
                "type": "string",
                "description": "选项文本。若选择\"其他\"并填写补充,格式为 \"其他[补充内容]\""
              }
            },
            "additionalProperties": false
          }
        }
      },
      "additionalProperties": false
    },
    "FieldValueChecklist": {
      "type": "array",
      "description": "检查清单字段值。适用 field_type: checklist",
      "items": {
        "type": "object",
        "required": [
          "item_id",
          "item_title",
          "value"
        ],
        "properties": {
          "item_id": {
            "type": "integer",
            "description": "检查项ID"
          },
          "item_title": {
            "type": "string",
            "description": "检查项标题"
          },
          "value": {
            "type": "object",
            "required": [
              "option_id",
              "option_text",
              "description",
              "images"
            ],
            "properties": {
              "option_id": {
                "type": "integer",
                "description": "选择的选项ID"
              },
              "option_text": {
                "type": "string",
                "description": "选择的选项文本(如 正常、异常、需要关注)"
              },
              "description": {
                "type": "string",
                "description": "补充描述(无描述时为空字符串)"
              },
              "images": {
                "type": "array",
                "description": "补充图片列表",
                "items": {
                  "$ref": "#/$defs/ImageItem"
                }
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      }
    },
    "FieldValueMatrix": {
      "type": "object",
      "description": "矩阵(单行)字段值。适用 field_type: matrix",
      "required": [
        "columns"
      ],
      "properties": {
        "columns": {
          "type": "array",
          "description": "列数据列表",
          "items": {
            "$ref": "#/$defs/MatrixColumn"
          }
        }
      },
      "additionalProperties": false
    },
    "FieldValueDynamicMatrix": {
      "type": "object",
      "description": "动态矩阵(多行)字段值。适用 field_type: dynamic_matrix",
      "required": [
        "rows"
      ],
      "properties": {
        "rows": {
          "type": "array",
          "description": "行数据列表",
          "items": {
            "type": "object",
            "required": [
              "columns"
            ],
            "properties": {
              "columns": {
                "type": "array",
                "items": {
                  "$ref": "#/$defs/MatrixColumn"
                }
              }
            },
            "additionalProperties": false
          }
        }
      },
      "additionalProperties": false
    },
    "MatrixColumn": {
      "type": "object",
      "description": "矩阵中的单个列",
      "required": [
        "column_id",
        "column_title",
        "column_type",
        "value"
      ],
      "properties": {
        "column_id": {
          "type": "integer",
          "description": "列ID"
        },
        "column_title": {
          "type": "string",
          "description": "列标题"
        },
        "column_type": {
          "type": "string",
          "description": "列类型(text, sex, identity, date, owner_address 等)"
        },
        "value": {
          "type": "object",
          "required": [
            "text",
            "option_uuid"
          ],
          "properties": {
            "text": {
              "type": [
                "string",
                "null"
              ],
              "description": "文本值"
            },
            "option_uuid": {
              "type": [
                "string",
                "null"
              ],
              "description": "选项 UUID,非选择类列为 null"
            }
          },
          "additionalProperties": false
        }
      },
      "additionalProperties": false
    },
    "FieldValueAddress": {
      "type": "object",
      "description": "地址定位字段值。适用 field_type: address",
      "required": [
        "address",
        "lat",
        "lng"
      ],
      "properties": {
        "address": {
          "type": "string",
          "description": "地址文本"
        },
        "lat": {
          "type": "number",
          "description": "纬度"
        },
        "lng": {
          "type": "number",
          "description": "经度"
        }
      },
      "additionalProperties": false
    },
    "FieldValueOwnerAddress": {
      "type": "object",
      "description": "详细地址字段值(省/市/区/街道/详细)。适用 field_type: owner_address",
      "required": [
        "province",
        "city",
        "district",
        "street",
        "detail",
        "full_address"
      ],
      "properties": {
        "province": {
          "type": "string",
          "description": "省份"
        },
        "city": {
          "type": "string",
          "description": "城市"
        },
        "district": {
          "type": "string",
          "description": "区/县"
        },
        "street": {
          "type": "string",
          "description": "街道/乡镇"
        },
        "detail": {
          "type": "string",
          "description": "详细地址"
        },
        "full_address": {
          "type": "string",
          "description": "完整地址拼接"
        }
      },
      "additionalProperties": false
    },
    "FieldValueChainedSelects": {
      "type": "object",
      "description": "级联选择字段值。适用 field_type: chained_selects",
      "required": [
        "values"
      ],
      "properties": {
        "values": {
          "type": "array",
          "description": "各级选择值(按 level 升序排列)",
          "items": {
            "type": "object",
            "required": [
              "option_id",
              "option_text",
              "level"
            ],
            "properties": {
              "option_id": {
                "type": "integer",
                "description": "选项ID"
              },
              "option_text": {
                "type": "string",
                "description": "选项文本"
              },
              "level": {
                "type": "integer",
                "description": "层级(从 1 开始)"
              }
            },
            "additionalProperties": false
          }
        }
      },
      "additionalProperties": false
    },
    "FieldValueImageList": {
      "type": "array",
      "description": "图片/签名字段值。适用 field_type: image, signature",
      "items": {
        "$ref": "#/$defs/ImageItem"
      }
    },
    "FieldValueAudioList": {
      "type": "array",
      "description": "音频字段值。适用 field_type: audio",
      "items": {
        "type": "object",
        "required": [
          "url",
          "size",
          "duration"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "音频文件 URL"
          },
          "size": {
            "type": [
              "integer",
              "null"
            ],
            "description": "文件大小(字节),可能为 null"
          },
          "duration": {
            "type": "number",
            "description": "时长(秒)"
          },
          "translated_text": {
            "type": [
              "string",
              "null"
            ],
            "description": "语音转文字内容"
          },
          "abstract_text": {
            "type": [
              "string",
              "null"
            ],
            "description": "语音摘要文本"
          },
          "upload_time_iso": {
            "type": "string",
            "description": "上传时间(格式:Y-m-d H:i:s(UTC+08:00))"
          }
        },
        "additionalProperties": false
      }
    },
    "FieldValueVideoList": {
      "type": "array",
      "description": "视频字段值。适用 field_type: video",
      "items": {
        "type": "object",
        "required": [
          "url",
          "size",
          "duration"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "视频文件 URL"
          },
          "size": {
            "type": [
              "integer",
              "null"
            ],
            "description": "文件大小(字节)"
          },
          "duration": {
            "type": "number",
            "description": "时长(秒)"
          },
          "upload_time_iso": {
            "type": "string",
            "description": "上传时间(格式:Y-m-d H:i:s(UTC+08:00))"
          }
        },
        "additionalProperties": false
      }
    },
    "FieldValueFileList": {
      "type": "array",
      "description": "文件字段值。适用 field_type: file",
      "items": {
        "type": "object",
        "required": [
          "url",
          "size",
          "file_name"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "文件下载 URL"
          },
          "size": {
            "type": [
              "integer",
              "null"
            ],
            "description": "文件大小(字节)"
          },
          "file_name": {
            "type": "string",
            "description": "文件名(含扩展名)"
          },
          "upload_time_iso": {
            "type": "string",
            "description": "上传时间(格式:Y-m-d H:i:s(UTC+08:00))"
          }
        },
        "additionalProperties": false
      }
    },
    "FieldValueDescription": {
      "type": "object",
      "description": "说明/描述字段值。适用 field_type: description",
      "required": [
        "description_html"
      ],
      "properties": {
        "description_html": {
          "type": "string",
          "description": "富文本 HTML 内容"
        }
      },
      "additionalProperties": false
    },
    "FieldValueOcr": {
      "type": "object",
      "description": "OCR 识别字段值。适用 field_type: ocr_id_card, ocr_bank_card, ocr_vehicle_license, ocr_driving_license, ocr_car_number, ocr_car_vin, ocr_business_license, ocr_way_bill, ocr_special_operate, ocr_general_cert, ocr_degree_cert, ocr_diploma_cert, ocr_dashboard_mile, ocr_electric_meter, ocr_water_meter, ocr_hygrother_mograp, ocr_gas_meter, ocr_pressure_meter, ocr_general_meter, ocr_digital_meter, ocr_roll_meter, ocr_pointer_meter, ocr_liquid_column_meter",
      "required": [
        "items",
        "image"
      ],
      "properties": {
        "items": {
          "type": "array",
          "description": "OCR 识别结果项列表",
          "items": {
            "type": "object",
            "required": [
              "item_id",
              "item_title",
              "value",
              "unit",
              "unit_enabled"
            ],
            "properties": {
              "item_id": {
                "type": "integer",
                "description": "识别项ID"
              },
              "item_title": {
                "type": "string",
                "description": "识别项标题"
              },
              "value": {
                "type": "string",
                "description": "识别结果值"
              },
              "unit": {
                "type": "string",
                "description": "单位(无单位时为空字符串)"
              },
              "unit_enabled": {
                "type": "boolean",
                "description": "是否启用单位"
              }
            },
            "additionalProperties": false
          }
        },
        "image": {
          "oneOf": [
            {
              "$ref": "#/$defs/ImageItem"
            },
            {
              "type": "null"
            }
          ],
          "description": "OCR 源图片(部分 OCR 类型无源图片时为 null)"
        }
      },
      "additionalProperties": false
    },
    "AiImageAuditResult": {
      "type": "object",
      "description": "AI 图片审核结果(仅当原始数据含审核信息时输出)",
      "required": [
        "audit_status",
        "audit_status_text",
        "reason"
      ],
      "properties": {
        "audit_status": {
          "type": "integer",
          "description": "0=默认,1=通过,2=不通过,3=失败,4=待审核"
        },
        "audit_status_text": {
          "type": "string",
          "description": "与 audit_status 对应的中文说明(默认、通过、不通过、失败、待审核)"
        },
        "reason": {
          "type": "string",
          "description": "AI 针对当前审核状态返回的原因说明"
        }
      },
      "additionalProperties": false
    },
    "ImageItem": {
      "type": "object",
      "description": "图片资源",
      "required": [
        "url",
        "size",
        "width",
        "height"
      ],
      "properties": {
        "url": {
          "type": "string",
          "format": "uri",
          "description": "图片 URL"
        },
        "size": {
          "type": [
            "integer",
            "null"
          ],
          "description": "文件大小(字节)"
        },
        "width": {
          "type": "integer",
          "description": "图片宽度(像素)"
        },
        "height": {
          "type": "integer",
          "description": "图片高度(像素)"
        },
        "upload_time_iso": {
          "type": "string",
          "description": "上传时间(格式:Y-m-d H:i:s(UTC+08:00))"
        },
        "ai_audit_result": {
          "$ref": "#/$defs/AiImageAuditResult",
          "description": "可选;无 AI 审核数据时不返回"
        }
      },
      "additionalProperties": false
    },
    "FieldValueSubQrcodeEditChangeList": {
      "type": "array",
      "description": "子码编辑变更记录列表。适用 field_type: sub_qrcode_edit_diff。每个元素代表一个被修改的字段及其修改前后的值。",
      "items": {
        "$ref": "#/$defs/SubQrcodeEditChangeItem"
      }
    },
    "SubQrcodeEditChangeItem": {
      "type": "object",
      "description": "子码编辑的单个字段变更记录",
      "required": [
        "field_id",
        "field_title",
        "field_type",
        "before_value",
        "after_value"
      ],
      "properties": {
        "field_id": {
          "type": "integer",
          "description": "被修改的原始字段ID"
        },
        "field_title": {
          "type": "string",
          "description": "被修改的原始字段标题"
        },
        "field_type": {
          "type": "string",
          "description": "被修改的原始字段类型",
          "enum": [
            "text",
            "textarea",
            "number",
            "date",
            "time",
            "radio",
            "checkbox",
            "address",
            "image",
            "signature",
            "audio",
            "video",
            "file"
          ]
        },
        "before_value": {
          "$ref": "#/$defs/SubQrcodeEditChangeContent"
        },
        "after_value": {
          "$ref": "#/$defs/SubQrcodeEditChangeContent"
        }
      },
      "additionalProperties": false
    },
    "SubQrcodeEditChangeContent": {
      "type": "object",
      "description": "变更前/后的内容。非媒体字段使用 text_content;媒体字段使用 media_items。",
      "required": [
        "text_content",
        "media_items"
      ],
      "properties": {
        "text_content": {
          "type": "string",
          "description": "文本内容(非媒体字段的值,媒体字段时为空字符串)"
        },
        "media_items": {
          "type": "array",
          "description": "媒体项列表(媒体字段的值,非媒体字段时为空数组)。元素结构随所属变更项的 field_type 不同而变化。",
          "items": {
            "$ref": "#/$defs/SubQrcodeEditChangeMediaItem"
          }
        }
      },
      "additionalProperties": false
    },
    "SubQrcodeEditChangeMediaItem": {
      "type": "object",
      "description": "变更内容中的媒体资源项。根据所属变更项的 field_type 不同,包含不同属性:image/signature 有 width/height;audio 有 duration/translated_text/abstract_text;video 有 duration;file 有 file_name。",
      "required": [
        "url"
      ],
      "properties": {
        "url": {
          "type": "string",
          "format": "uri",
          "description": "资源 URL"
        },
        "size": {
          "type": [
            "integer",
            "null"
          ],
          "description": "文件大小(字节)"
        },
        "width": {
          "type": "integer",
          "description": "图片宽度(px)—— 仅 image/signature"
        },
        "height": {
          "type": "integer",
          "description": "图片高度(px)—— 仅 image/signature"
        },
        "duration": {
          "type": "number",
          "description": "时长(秒)—— 仅 audio/video"
        },
        "file_name": {
          "type": "string",
          "description": "文件名(含扩展名)—— 仅 file"
        },
        "translated_text": {
          "type": [
            "string",
            "null"
          ],
          "description": "语音转文字 —— 仅 audio"
        },
        "abstract_text": {
          "type": [
            "string",
            "null"
          ],
          "description": "语音摘要 —— 仅 audio"
        },
        "ai_audit_result": {
          "$ref": "#/$defs/AiImageAuditResult",
          "description": "可选;image/signature 变更项在含审核数据时返回"
        }
      },
      "additionalProperties": false
    }
  }
}
Full examples
json
{
  "code": 0,
  "message": "ok",
  "data": {
    "format": "json",
    "content_type": "application/json; charset=utf-8",
    "data": {
      "recorder": {
        "auth_id": 20001,
        "user_id": 30001,
        "name": "张**"
      },
      "tpl_groups": [
        {
          "group_id": 71399639089153,
          "group_title": "",
          "show_group_title": false,
          "is_page_break_group": false,
          "fields": [
            {
              "field_id": 71399639089153,
              "field_title": "巡检人姓名",
              "field_desc": "",
              "field_type": "name",
              "field_short_name": "",
              "group_id": 71399639089153,
              "field_value": "黄**",
              "options": {
                "is_result": false,
                "is_highlight": false,
                "is_hidden": false,
                "is_masked": true
              }
            },
            {
              "field_id": 71399639089154,
              "field_title": "巡检人手机号",
              "field_desc": "",
              "field_type": "tel",
              "field_short_name": "",
              "group_id": 71399639089153,
              "field_value": "136****9379",
              "options": {
                "is_result": false,
                "is_highlight": false,
                "is_hidden": false,
                "is_masked": true
              }
            },
            {
              "field_id": 71399639089155,
              "field_title": "巡检人微信名",
              "field_desc": "",
              "field_type": "recorder",
              "field_short_name": "",
              "group_id": 71399639089153,
              "field_value": "黄**",
              "options": {
                "is_result": false,
                "is_highlight": false,
                "is_hidden": false,
                "is_masked": false
              }
            },
            {
              "field_id": 71399639089156,
              "field_title": "巡检人身份证号",
              "field_desc": "",
              "field_type": "identity",
              "field_short_name": "",
              "group_id": 71399639089153,
              "field_value": "3604**********5517",
              "options": {
                "is_result": false,
                "is_highlight": false,
                "is_hidden": false,
                "is_masked": true
              }
            },
            {
              "field_id": 71399639089157,
              "field_title": "巡检人工号",
              "field_desc": "",
              "field_type": "job_number",
              "field_short_name": "",
              "group_id": 71399639089153,
              "field_value": "NO-1001",
              "options": {
                "is_result": false,
                "is_highlight": false,
                "is_hidden": false,
                "is_masked": false
              }
            },
            {
              "field_id": 71399639089158,
              "field_title": "巡检人性别",
              "field_desc": "",
              "field_type": "sex",
              "field_short_name": "",
              "group_id": 71399639089153,
              "field_value": {
                "option_text": "男",
                "option_id": 71399639089192
              },
              "options": {
                "is_result": false,
                "is_highlight": false,
                "is_hidden": false,
                "is_masked": false
              }
            }
          ]
        },
        {
          "group_id": 71399639089154,
          "group_title": "巡检人基本信息",
          "show_group_title": true,
          "is_page_break_group": true,
          "fields": []
        },
        {
          "group_id": 72331175133185,
          "group_title": "",
          "show_group_title": false,
          "is_page_break_group": false,
          "fields": [
            {
              "field_id": 71399639089159,
              "field_title": "巡检内容",
              "field_desc": "",
              "field_type": "text",
              "field_short_name": "",
              "group_id": 72331175133185,
              "field_value": "灭火器",
              "options": {
                "is_result": false,
                "is_highlight": false,
                "is_hidden": false,
                "is_masked": true
              }
            },
            {
              "field_id": 71399639089160,
              "field_title": "巡检描述",
              "field_desc": "",
              "field_type": "textarea",
              "field_short_name": "",
              "group_id": 72331175133185,
              "field_value": "灭火器正常摆放",
              "options": {
                "is_result": false,
                "is_highlight": false,
                "is_hidden": false,
                "is_masked": true
              }
            },
            {
              "field_id": 71399639089161,
              "field_title": "当前温度",
              "field_desc": "",
              "field_type": "number",
              "field_short_name": "",
              "group_id": 72331175133185,
              "field_value": {
                "value": 30.6,
                "unit": "摄氏度",
                "unit_enabled": true
              },
              "options": {
                "is_result": false,
                "is_highlight": false,
                "is_hidden": false,
                "is_masked": true
              }
            },
            {
              "field_id": 71399639089162,
              "field_title": "巡检次数",
              "field_desc": "",
              "field_type": "number",
              "field_short_name": "",
              "group_id": 72331175133185,
              "field_value": {
                "value": 96,
                "unit": "",
                "unit_enabled": false
              },
              "options": {
                "is_result": false,
                "is_highlight": false,
                "is_hidden": false,
                "is_masked": true
              }
            },
            {
              "field_id": 71399639089163,
              "field_title": "灭火器检查",
              "field_desc": "",
              "field_type": "checklist",
              "field_short_name": "",
              "group_id": 72331175133185,
              "field_value": [
                {
                  "item_id": 71399639089266,
                  "item_title": "压力正常",
                  "value": {
                    "option_id": 71399639089271,
                    "option_value": "1",
                    "option_text": "正常",
                    "description": "",
                    "images": []
                  }
                },
                {
                  "item_id": 71399639089267,
                  "item_title": "外观完好",
                  "value": {
                    "option_id": 71399639089272,
                    "option_value": "2",
                    "option_text": "异常",
                    "description": "生锈了,需要注意",
                    "images": [
                      {
                        "url": "https://example.com/assets/image-demo-001.jpg",
                        "width": 1080,
                        "size": 302744,
                        "height": 1920,
                        "upload_time_iso": "2026-03-09 15:57:04(UTC+08:00)"
                      }
                    ]
                  }
                },
                {
                  "item_id": 71399639089268,
                  "item_title": "配件齐全",
                  "value": {
                    "option_id": 71399639089273,
                    "option_value": "3",
                    "option_text": "需要关注",
                    "description": "不多不少刚刚好",
                    "images": []
                  }
                },
                {
                  "item_id": 71399639089269,
                  "item_title": "有效期内",
                  "value": {
                    "option_id": 71399639089271,
                    "option_value": "1",
                    "option_text": "正常",
                    "description": "",
                    "images": []
                  }
                },
                {
                  "item_id": 71399639089270,
                  "item_title": "放置位置正确",
                  "value": {
                    "option_id": 71399639089271,
                    "option_value": "1",
                    "option_text": "正常",
                    "description": "",
                    "images": []
                  }
                }
              ],
              "options": {
                "is_result": false,
                "is_highlight": false,
                "is_hidden": false,
                "is_masked": false
              }
            },
            {
              "field_id": 71399639089164,
              "field_title": "同行人信息",
              "field_desc": "",
              "field_type": "matrix",
              "field_short_name": "",
              "group_id": 72331175133185,
              "field_value": {
                "columns": [
                  {
                    "column_id": 71399639089283,
                    "column_title": "姓名",
                    "column_type": "text",
                    "value": {
                      "text": "张**",
                      "option_uuid": null
                    }
                  },
                  {
                    "column_id": 71399639089284,
                    "column_title": "手机号",
                    "column_type": "text",
                    "value": {
                      "text": "136****9379",
                      "option_uuid": null
                    }
                  },
                  {
                    "column_id": 71399639089285,
                    "column_title": "性别",
                    "column_type": "sex",
                    "value": {
                      "text": "男",
                      "option_uuid": "25587b8b-485d-4038-a5ab-9bcd7c4af880"
                    }
                  },
                  {
                    "column_id": 71399639089286,
                    "column_title": "身份证",
                    "column_type": "identity",
                    "value": {
                      "text": "3604**********5517",
                      "option_uuid": null
                    }
                  },
                  {
                    "column_id": 71399639089287,
                    "column_title": "年龄",
                    "column_type": "text",
                    "value": {
                      "text": "66",
                      "option_uuid": null
                    }
                  },
                  {
                    "column_id": 72326603341946,
                    "column_title": "婚姻状况",
                    "column_type": "radio",
                    "value": {
                      "text": "已婚",
                      "option_uuid": "33ac08a2-4d8e-4b9b-885f-378fbb3535dc"
                    }
                  }
                ]
              },
              "options": {
                "is_result": false,
                "is_highlight": false,
                "is_hidden": false,
                "is_masked": true
              }
            },
            {
              "field_id": 71399639089165,
              "field_title": "检查具体内容项",
              "field_desc": "",
              "field_type": "dynamic_matrix",
              "field_short_name": "",
              "group_id": 72331175133185,
              "field_value": {
                "rows": [
                  {
                    "columns": [
                      {
                        "column_id": 71399639089294,
                        "column_type": "text",
                        "column_title": "物品名称",
                        "value": {
                          "text": "螺丝",
                          "option_uuid": null
                        }
                      },
                      {
                        "column_id": 71399639089295,
                        "column_type": "owner_address",
                        "column_title": "物品厂家地址",
                        "value": {
                          "text": "示例省示例市示例区示例街道",
                          "option_uuid": null
                        }
                      },
                      {
                        "column_id": 71399639089296,
                        "column_type": "date",
                        "column_title": "生成日期",
                        "value": {
                          "text": "2026年03月12日",
                          "option_uuid": null
                        }
                      },
                      {
                        "column_id": 72326603341957,
                        "column_type": "radio",
                        "column_title": "单位",
                        "value": {
                          "text": "箱",
                          "option_uuid": "b145e3df-9bef-4690-afe9-f0bae872b5ad"
                        }
                      }
                    ]
                  },
                  {
                    "columns": [
                      {
                        "column_id": 71399639089294,
                        "column_type": "text",
                        "column_title": "物品名称",
                        "value": {
                          "text": "扳手",
                          "option_uuid": null
                        }
                      },
                      {
                        "column_id": 71399639089295,
                        "column_type": "owner_address",
                        "column_title": "物品厂家地址",
                        "value": {
                          "text": "示例省示例市示例区示例街道",
                          "option_uuid": null
                        }
                      },
                      {
                        "column_id": 71399639089296,
                        "column_type": "date",
                        "column_title": "生成日期",
                        "value": {
                          "text": "2026年03月27日",
                          "option_uuid": null
                        }
                      },
                      {
                        "column_id": 72326603341957,
                        "column_type": "radio",
                        "column_title": "单位",
                        "value": {
                          "text": "其他[枚]",
                          "option_uuid": "87936ac7-fb80-472f-ad4b-1c5ff6a71b8b"
                        }
                      }
                    ]
                  }
                ]
              },
              "options": {
                "is_result": false,
                "is_highlight": false,
                "is_hidden": false,
                "is_masked": true
              }
            },
            {
              "field_id": 71399639089166,
              "field_title": "巡检日期",
              "field_desc": "",
              "field_type": "date",
              "field_short_name": "",
              "group_id": 72331175133185,
              "field_value": "2026年03月09日 17时24分",
              "options": {
                "is_result": false,
                "is_highlight": false,
                "is_hidden": false,
                "is_masked": false
              }
            },
            {
              "field_id": 71399639089167,
              "field_title": "巡检时间",
              "field_desc": "",
              "field_type": "time",
              "field_short_name": "",
              "group_id": 72331175133185,
              "field_value": "2026-03-09 17:24",
              "options": {
                "is_result": false,
                "is_highlight": false,
                "is_hidden": false,
                "is_masked": false
              }
            },
            {
              "field_id": 72331175133185,
              "field_title": "是否需要报销",
              "field_desc": "",
              "field_type": "radio",
              "field_short_name": "",
              "group_id": 72331175133185,
              "field_value": {
                "option_text": "不需要",
                "option_id": 72331175133357
              },
              "options": {
                "is_result": false,
                "is_highlight": false,
                "is_hidden": false,
                "is_masked": false
              }
            },
            {
              "field_id": 71399639089168,
              "field_title": "设备情况",
              "field_desc": "",
              "field_type": "radio",
              "field_short_name": "",
              "group_id": 72331175133185,
              "field_value": {
                "option_text": "其他[一点小问题]",
                "option_id": 71399639089337
              },
              "options": {
                "is_result": true,
                "is_highlight": true,
                "is_hidden": false,
                "is_masked": false
              }
            },
            {
              "field_id": 71399639089169,
              "field_title": "环境情况",
              "field_desc": "",
              "field_type": "radio",
              "field_short_name": "",
              "group_id": 72331175133185,
              "field_value": {
                "option_text": "正常",
                "option_id": 71399639089348
              },
              "options": {
                "is_result": false,
                "is_highlight": false,
                "is_hidden": false,
                "is_masked": false
              }
            },
            {
              "field_id": 71399639089170,
              "field_title": "消耗工具",
              "field_desc": "",
              "field_type": "checkbox",
              "field_short_name": "",
              "group_id": 72331175133185,
              "field_value": {
                "values": [
                  {
                    "option_id": 71399639089361,
                    "option_text": "螺丝刀"
                  },
                  {
                    "option_id": 71399639089362,
                    "option_text": "扳手"
                  },
                  {
                    "option_id": 71399639089363,
                    "option_text": "万用表"
                  },
                  {
                    "option_id": 71399639089369,
                    "option_text": "其他[电线杆子]"
                  }
                ]
              },
              "options": {
                "is_result": false,
                "is_highlight": false,
                "is_hidden": false,
                "is_masked": false
              }
            }
          ]
        },
        {
          "group_id": 71399639089156,
          "group_title": "巡检内容",
          "show_group_title": true,
          "is_page_break_group": true,
          "fields": []
        },
        {
          "group_id": 72331175133186,
          "group_title": "",
          "show_group_title": false,
          "is_page_break_group": false,
          "fields": [
            {
              "field_id": 71399639089171,
              "field_title": "负责人姓名",
              "field_desc": "",
              "field_type": "customer_name",
              "field_short_name": "",
              "group_id": 72331175133186,
              "field_value": "黄**",
              "options": {
                "is_result": false,
                "is_highlight": false,
                "is_hidden": false,
                "is_masked": true
              }
            },
            {
              "field_id": 71399639089172,
              "field_title": "负责人手机号",
              "field_desc": "",
              "field_type": "customer_mobile",
              "field_short_name": "",
              "group_id": 72331175133186,
              "field_value": "136****9379",
              "options": {
                "is_result": false,
                "is_highlight": false,
                "is_hidden": false,
                "is_masked": true
              }
            },
            {
              "field_id": 71399639089173,
              "field_title": "设备定位",
              "field_desc": "",
              "field_type": "address",
              "field_short_name": "",
              "group_id": 72331175133186,
              "field_value": {
                "address": "示例省示例市示例区示例路100号",
                "lat": 30.123456,
                "lng": 120.123456
              },
              "options": {
                "is_result": false,
                "is_highlight": false,
                "is_hidden": false,
                "is_masked": true
              }
            },
            {
              "field_id": 71399639089174,
              "field_title": "安装地址",
              "field_desc": "",
              "field_type": "owner_address",
              "field_short_name": "",
              "group_id": 72331175133186,
              "field_value": {
                "province": "示例省",
                "city": "示例市",
                "district": "示例区",
                "street": "示例街道",
                "detail": "示例路100号",
                "full_address": "示例省示例市示例区示例街道示例路100号"
              },
              "options": {
                "is_result": false,
                "is_highlight": false,
                "is_hidden": false,
                "is_masked": true
              }
            },
            {
              "field_id": 71399639089175,
              "field_title": "运输车辆车牌",
              "field_desc": "",
              "field_type": "carnumber",
              "field_short_name": "",
              "group_id": 72331175133186,
              "field_value": "京A1***5",
              "options": {
                "is_result": false,
                "is_highlight": false,
                "is_hidden": false,
                "is_masked": false
              }
            },
            {
              "field_id": 71399639089176,
              "field_title": "负责人手写签名",
              "field_desc": "",
              "field_type": "signature",
              "field_short_name": "",
              "group_id": 72331175133186,
              "field_value": [
                {
                  "url": "https://example.com/assets/image-demo-002.png",
                  "size": 7420,
                  "width": 1000,
                  "height": 558,
                  "upload_time_iso": "2026-03-09 17:29:25(UTC+08:00)"
                }
              ],
              "options": {
                "is_result": false,
                "is_highlight": false,
                "is_hidden": false,
                "is_masked": false
              }
            },
            {
              "field_id": 71399639089177,
              "field_title": "培训学校",
              "field_desc": "",
              "field_type": "chained_selects",
              "field_short_name": "",
              "group_id": 72331175133186,
              "field_value": {
                "values": [
                  {
                    "option_id": 71399639089433,
                    "option_text": "浙江省",
                    "level": 1
                  },
                  {
                    "option_id": 71399639089443,
                    "option_text": "杭州市",
                    "level": 2
                  },
                  {
                    "option_id": 71399639089447,
                    "option_text": "下城区",
                    "level": 3
                  },
                  {
                    "option_id": 71399639089448,
                    "option_text": "学校1",
                    "level": 4
                  }
                ]
              },
              "options": {
                "is_result": false,
                "is_highlight": false,
                "is_hidden": false,
                "is_masked": false
              }
            }
          ]
        },
        {
          "group_id": 71399639089158,
          "group_title": "负责人信息",
          "show_group_title": true,
          "is_page_break_group": true,
          "fields": []
        },
        {
          "group_id": 72331175133187,
          "group_title": "",
          "show_group_title": false,
          "is_page_break_group": false,
          "fields": [
            {
              "field_id": 71399639089178,
              "field_title": "补充图片",
              "field_desc": "",
              "field_type": "image",
              "field_short_name": "",
              "group_id": 72331175133187,
              "field_value": [
                {
                  "url": "https://example.com/assets/image-demo-003.jpg",
                  "size": 310258,
                  "width": 1080,
                  "height": 1920,
                  "upload_time_iso": "2026-03-09 17:27:07(UTC+08:00)"
                },
                {
                  "url": "https://example.com/assets/image-demo-004.jpg",
                  "size": 211310,
                  "width": 1080,
                  "height": 1920,
                  "upload_time_iso": "2026-03-09 17:27:07(UTC+08:00)"
                }
              ],
              "options": {
                "is_result": false,
                "is_highlight": false,
                "is_hidden": false,
                "is_masked": false
              }
            },
            {
              "field_id": 71399639089179,
              "field_title": "补充录音",
              "field_desc": "",
              "field_type": "audio",
              "field_short_name": "",
              "group_id": 72331175133187,
              "field_value": [
                {
                  "url": "https://example.com/assets/audio-demo-001.mp3",
                  "size": null,
                  "duration": 3.12,
                  "translated_text": null,
                  "abstract_text": null,
                  "upload_time_iso": "2026-03-09 17:27:13(UTC+08:00)"
                }
              ],
              "options": {
                "is_result": false,
                "is_highlight": false,
                "is_hidden": false,
                "is_masked": false
              }
            },
            {
              "field_id": 71399639089180,
              "field_title": "补充文件",
              "field_desc": "",
              "field_type": "file",
              "field_short_name": "",
              "group_id": 72331175133187,
              "field_value": [
                {
                  "url": "https://example.com/assets/file-demo-001.docx",
                  "size": 435177,
                  "file_name": "1月23日.docx",
                  "upload_time_iso": "2026-03-09 17:27:23(UTC+08:00)"
                }
              ],
              "options": {
                "is_result": false,
                "is_highlight": false,
                "is_hidden": false,
                "is_masked": false
              }
            },
            {
              "field_id": 71399639089181,
              "field_title": "补充视频",
              "field_desc": "",
              "field_type": "video",
              "field_short_name": "",
              "group_id": 72331175133187,
              "field_value": [
                {
                  "url": "https://example.com/assets/video-demo-001.mp4",
                  "size": 199415,
                  "duration": 3,
                  "upload_time_iso": "2026-03-09 17:27:35(UTC+08:00)"
                }
              ],
              "options": {
                "is_result": false,
                "is_highlight": false,
                "is_hidden": false,
                "is_masked": false
              }
            }
          ]
        },
        {
          "group_id": 71399639089160,
          "group_title": "其他补充材料",
          "show_group_title": true,
          "is_page_break_group": true,
          "fields": []
        },
        {
          "group_id": 72331175133188,
          "group_title": "",
          "show_group_title": false,
          "is_page_break_group": false,
          "fields": [
            {
              "field_id": 71399639089182,
              "field_title": "填表时请注意以下说明",
              "field_desc": "",
              "field_type": "description",
              "field_short_name": "",
              "group_id": 72331175133188,
              "field_value": {
                "description_html": "<p><span style=\"font-size: 14px;\">设备巡检示例说明:本文档中的返回示例已做脱敏处理,用于演示说明和结构校验。</span></p>"
              },
              "options": {
                "is_result": false,
                "is_highlight": false,
                "is_hidden": false,
                "is_masked": false
              }
            },
            {
              "field_id": 71399639089183,
              "field_title": "卖家身份证信息",
              "field_desc": "请正面拍摄身份证,要求内容清晰完整,方便AI识别",
              "field_type": "ocr_id_card",
              "field_short_name": "",
              "group_id": 72331175133188,
              "field_value": {
                "items": [
                  {
                    "item_id": 71399639089533,
                    "item_title": "身份证号",
                    "value": "4403**********3527",
                    "unit": "",
                    "unit_enabled": false
                  },
                  {
                    "item_id": 71399639089534,
                    "item_title": "姓名",
                    "value": "黄**",
                    "unit": "",
                    "unit_enabled": false
                  },
                  {
                    "item_id": 71399639089535,
                    "item_title": "性别",
                    "value": "女",
                    "unit": "",
                    "unit_enabled": false
                  },
                  {
                    "item_id": 71399639089536,
                    "item_title": "民族",
                    "value": "汉",
                    "unit": "",
                    "unit_enabled": false
                  },
                  {
                    "item_id": 71399639089537,
                    "item_title": "出生日期",
                    "value": "2018年05月18日",
                    "unit": "",
                    "unit_enabled": false
                  },
                  {
                    "item_id": 71399639089538,
                    "item_title": "地址",
                    "value": "示例省示例市示例区示例街道66号",
                    "unit": "",
                    "unit_enabled": false
                  }
                ],
                "image": null
              },
              "options": {
                "is_result": false,
                "is_highlight": false,
                "is_hidden": false,
                "is_masked": true
              }
            }
          ]
        },
        {
          "group_id": 71399639089162,
          "group_title": "操作说明",
          "show_group_title": true,
          "is_page_break_group": true,
          "fields": []
        },
        {
          "group_id": 72331175133189,
          "group_title": "",
          "show_group_title": false,
          "is_page_break_group": false,
          "fields": [
            {
              "field_id": 71399639089184,
              "field_title": "营业执照信息",
              "field_desc": "请正面拍摄营业执照,要求内容清晰完整,方便AI识别",
              "field_type": "ocr_business_license",
              "field_short_name": "",
              "group_id": 72331175133189,
              "field_value": {
                "items": [
                  {
                    "item_id": 71399639089549,
                    "item_title": "统一社会信用代码",
                    "value": "91350000MA0000000X",
                    "unit": "",
                    "unit_enabled": false
                  },
                  {
                    "item_id": 71399639089550,
                    "item_title": "企业名称",
                    "value": "示例企业(个体工商户)",
                    "unit": "",
                    "unit_enabled": false
                  },
                  {
                    "item_id": 71399639089551,
                    "item_title": "类型",
                    "value": "有限责任公司(台港澳法人独资)",
                    "unit": "",
                    "unit_enabled": false
                  },
                  {
                    "item_id": 71399639089552,
                    "item_title": "营业场所/住所",
                    "value": "示例省示例市示例区示例街道66号",
                    "unit": "",
                    "unit_enabled": false
                  },
                  {
                    "item_id": 71399639089553,
                    "item_title": "法人/负责人",
                    "value": "朱**",
                    "unit": "",
                    "unit_enabled": false
                  },
                  {
                    "item_id": 71399639089554,
                    "item_title": "经营范围",
                    "value": "水处理设备,环保产品及零部件,空气调节设备及其零部件、家用电器、燃气器具、电热水器具、太阳能设备、医疗器械的研究、批发、进出口、佣金代理(拍卖除外)并提供相关配套服务。【依法须经批准的项目,经相关部门批准后方可开展经营活动】",
                    "unit": "",
                    "unit_enabled": false
                  },
                  {
                    "item_id": 71399639089555,
                    "item_title": "注册资本",
                    "value": "人民币100万",
                    "unit": "",
                    "unit_enabled": false
                  },
                  {
                    "item_id": 71399639089556,
                    "item_title": "营业期限",
                    "value": "2019年08月28日至2049年08月27日",
                    "unit": "",
                    "unit_enabled": false
                  },
                  {
                    "item_id": 71399639089557,
                    "item_title": "统一社会信用代码",
                    "value": "91350000MA0000000X",
                    "unit": "",
                    "unit_enabled": false
                  },
                  {
                    "item_id": 71399639089558,
                    "item_title": "格式化营业期限起始日期",
                    "value": "2019年08月28日",
                    "unit": "",
                    "unit_enabled": false
                  },
                  {
                    "item_id": 71399639089559,
                    "item_title": "格式化营业期限终止日期",
                    "value": "2049年08月27日",
                    "unit": "",
                    "unit_enabled": false
                  },
                  {
                    "item_id": 71399639089560,
                    "item_title": "组成形式",
                    "value": "个人",
                    "unit": "",
                    "unit_enabled": false
                  },
                  {
                    "item_id": 71399639089561,
                    "item_title": "发照日期",
                    "value": "2019年08月28日",
                    "unit": "",
                    "unit_enabled": false
                  },
                  {
                    "item_id": 71399639089562,
                    "item_title": "证照标题",
                    "value": "营业执照",
                    "unit": "",
                    "unit_enabled": false
                  }
                ],
                "image": {
                  "url": "https://example.com/assets/image-demo-005.jpg",
                  "width": 1080,
                  "size": 302036,
                  "height": 1920,
                  "upload_time_iso": "2026-03-09 17:28:47(UTC+08:00)"
                }
              },
              "options": {
                "is_result": false,
                "is_highlight": false,
                "is_hidden": false,
                "is_masked": true
              }
            },
            {
              "field_id": 71399639089185,
              "field_title": "电表读数",
              "field_desc": "请正面拍摄电表,要求内容清晰完整,方便AI识别",
              "field_type": "ocr_electric_meter",
              "field_short_name": "",
              "group_id": 72331175133189,
              "field_value": {
                "items": [
                  {
                    "item_id": 71399639089571,
                    "item_title": "度数",
                    "value": "10890.1",
                    "unit": "度",
                    "unit_enabled": true
                  }
                ],
                "image": {
                  "url": "https://example.com/assets/image-demo-006.jpg",
                  "width": 1080,
                  "size": 316701,
                  "height": 1920,
                  "upload_time_iso": "2026-03-09 17:29:07(UTC+08:00)"
                }
              },
              "options": {
                "is_result": false,
                "is_highlight": false,
                "is_hidden": false,
                "is_masked": false
              }
            },
            {
              "field_id": 71399639089186,
              "field_title": "产品编号",
              "field_desc": "",
              "field_type": "customer_number",
              "field_short_name": "",
              "group_id": 72331175133189,
              "field_value": "PRD-0001",
              "options": {
                "is_result": false,
                "is_highlight": false,
                "is_hidden": false,
                "is_masked": false
              }
            }
          ]
        },
        {
          "group_id": 71399639089164,
          "group_title": "其他信息",
          "show_group_title": true,
          "is_page_break_group": true,
          "fields": []
        }
      ],
      "record_id": 10001,
      "process_status": {
        "enabled": true,
        "text": "处理中",
        "color": "#155EB7"
      },
      "project": {
        "id": 40001,
        "name": "示例园区",
        "number": "P001"
      },
      "qrcode": {
        "id": 50001,
        "name": "示例点位A",
        "type": 0,
        "type_text": "普通二维码",
        "template_id": 50010,
        "qrcode_url": "https://example.com/qrcodes/qrcode-demo-001",
        "number": "",
        "category_id": 50020
      },
      "org": {
        "id": 60001,
        "name": "示例企业",
        "code": "org_demo_code",
        "logo_url": "https://example.com/assets/logo-demo.png"
      },
      "record_template": {
        "id": 70001,
        "name": "设备巡检示例",
        "type": 0,
        "type_text": "普通表单",
        "number": "TPL-001"
      },
      "audit": {
        "enabled": true,
        "current_stage_id": 80001,
        "current_stage_title": "组长审批",
        "status": 0,
        "status_text": "待审核",
        "auditor_name": "李**"
      },
      "state_changes": [],
      "trusted_notary": {
        "tx_hash": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2",
        "evidence_url": "https://example.com/notary/2026/0407/13/evidence-demo-001.md",
        "notarized_at": 1775539953,
        "notarized_at_iso": "2026-04-07 13:32:33(UTC+08:00)"
      },
      "record_number": "REC-001",
      "record_code": "record_demo_code_001",
      "record_url": "https://example.com/records/record-demo-001",
      "submit_at": 1773056539,
      "submit_at_iso": "2026-03-09 19:42:19(UTC+08:00)",
      "submit_method": "扫一扫填写"
    }
  }
}
json
{
  "code": 0,
  "message": "ok",
  "data": {
    "format": "json",
    "content_type": "application/json; charset=utf-8",
    "data": {
      "recorder": {
        "auth_id": 20001,
        "user_id": 30001,
        "name": "张**"
      },
      "tpl_groups": [
        {
          "group_id": 36546780594177,
          "group_title": "",
          "show_group_title": false,
          "is_page_break_group": false,
          "fields": [
            {
              "field_id": 36546780594177,
              "field_title": "修改内容",
              "field_desc": "",
              "field_type": "sub_qrcode_edit_diff",
              "field_short_name": "",
              "group_id": 36546780594177,
              "field_value": [
                {
                  "field_id": 71501254492164,
                  "field_title": "编号",
                  "field_type": "text",
                  "before_value": {
                    "text_content": "NO-1001",
                    "media_items": []
                  },
                  "after_value": {
                    "text_content": "SUB-1001",
                    "media_items": []
                  }
                },
                {
                  "field_id": 71501254492165,
                  "field_title": "设备描述",
                  "field_type": "textarea",
                  "before_value": {
                    "text_content": "标准的灭火器",
                    "media_items": []
                  },
                  "after_value": {
                    "text_content": "标准的灭火器,都是好的",
                    "media_items": []
                  }
                },
                {
                  "field_id": 71501254492166,
                  "field_title": "数量",
                  "field_type": "number",
                  "before_value": {
                    "text_content": "10",
                    "media_items": []
                  },
                  "after_value": {
                    "text_content": "100",
                    "media_items": []
                  }
                },
                {
                  "field_id": 71501254492167,
                  "field_title": "生产日期",
                  "field_type": "date",
                  "before_value": {
                    "text_content": "2026-02-28",
                    "media_items": []
                  },
                  "after_value": {
                    "text_content": "2026-05-28 00:00",
                    "media_items": []
                  }
                },
                {
                  "field_id": 71501254492168,
                  "field_title": "当前状态",
                  "field_type": "radio",
                  "before_value": {
                    "text_content": "正常",
                    "media_items": []
                  },
                  "after_value": {
                    "text_content": "异常",
                    "media_items": []
                  }
                },
                {
                  "field_id": 71501254492169,
                  "field_title": "包含附件",
                  "field_type": "checkbox",
                  "before_value": {
                    "text_content": "喷嘴,水管,其他(螺丝)",
                    "media_items": []
                  },
                  "after_value": {
                    "text_content": "喷嘴,其他(老虎钳)",
                    "media_items": []
                  }
                },
                {
                  "field_id": 71501254492170,
                  "field_title": "设备定位",
                  "field_type": "address",
                  "before_value": {
                    "text_content": "示例地点A",
                    "media_items": []
                  },
                  "after_value": {
                    "text_content": "示例地点A",
                    "media_items": []
                  }
                },
                {
                  "field_id": 71501254492171,
                  "field_title": "现场照片",
                  "field_type": "image",
                  "before_value": {
                    "text_content": "",
                    "media_items": [
                      {
                        "url": "https://example.com/assets/image-demo-007.jpg",
                        "size": 141122,
                        "width": 1080,
                        "height": 1851
                      }
                    ]
                  },
                  "after_value": {
                    "text_content": "",
                    "media_items": [
                      {
                        "url": "https://example.com/assets/image-demo-008.jpg",
                        "size": 57778,
                        "width": 640,
                        "height": 854
                      }
                    ]
                  }
                },
                {
                  "field_id": 71501254492172,
                  "field_title": "说明文件",
                  "field_type": "file",
                  "before_value": {
                    "text_content": "",
                    "media_items": [
                      {
                        "url": "https://example.com/assets/file-demo-002.xlsx",
                        "size": 5280,
                        "file_name": "办公室巡查_D542_二维码统计.xlsx"
                      }
                    ]
                  },
                  "after_value": {
                    "text_content": "",
                    "media_items": [
                      {
                        "url": "https://example.com/assets/file-demo-003.pdf",
                        "size": 2179410,
                        "file_name": "第七单元练练吧.pdf"
                      }
                    ]
                  }
                },
                {
                  "field_id": 71501254492173,
                  "field_title": "操作指南",
                  "field_type": "audio",
                  "before_value": {
                    "text_content": "",
                    "media_items": [
                      {
                        "url": "https://example.com/assets/audio-demo-002.mp3",
                        "size": null,
                        "duration": 291.96,
                        "translated_text": null,
                        "abstract_text": null
                      }
                    ]
                  },
                  "after_value": {
                    "text_content": "",
                    "media_items": [
                      {
                        "url": "https://example.com/assets/audio-demo-003.mp3",
                        "size": null,
                        "duration": 4.04,
                        "translated_text": null,
                        "abstract_text": null
                      }
                    ]
                  }
                },
                {
                  "field_id": 71501254492174,
                  "field_title": "操作视频",
                  "field_type": "video",
                  "before_value": {
                    "text_content": "",
                    "media_items": [
                      {
                        "url": "https://example.com/assets/video-demo-002.mp4",
                        "size": 224532,
                        "duration": 5.44
                      }
                    ]
                  },
                  "after_value": {
                    "text_content": "",
                    "media_items": [
                      {
                        "url": "https://example.com/assets/video-demo-003.mp4",
                        "size": 217204,
                        "duration": 3
                      }
                    ]
                  }
                }
              ],
              "options": {
                "is_result": false,
                "is_highlight": false,
                "is_hidden": false,
                "is_masked": false
              }
            },
            {
              "field_id": 36546780594178,
              "field_title": "操作地点",
              "field_desc": "",
              "field_type": "address",
              "field_short_name": "",
              "group_id": 36546780594177,
              "field_value": {
                "address": "示例省示例市示例区示例路100号",
                "lat": 30.123456,
                "lng": 120.123456
              },
              "options": {
                "is_result": false,
                "is_highlight": false,
                "is_hidden": false,
                "is_masked": false
              }
            }
          ]
        }
      ],
      "record_id": 10002,
      "process_status": {
        "enabled": false,
        "text": null,
        "color": null
      },
      "project": {
        "id": 40001,
        "name": "示例园区",
        "number": "P001"
      },
      "qrcode": {
        "id": 50002,
        "name": "示例子码A",
        "type": 3,
        "type_text": "批量模板子码",
        "template_id": 50011,
        "qrcode_url": "https://example.com/qrcodes/qrcode-demo-002",
        "number": "",
        "category_id": 50021
      },
      "org": {
        "id": 60001,
        "name": "示例企业",
        "code": "org_demo_code",
        "logo_url": "https://example.com/assets/logo-demo.png"
      },
      "record_template": {
        "id": 70002,
        "name": "子码编辑记录示例",
        "type": 13,
        "type_text": "子码编辑记录系统表单",
        "number": "TPL-EDIT-001"
      },
      "audit": {
        "enabled": false,
        "current_stage_id": null,
        "current_stage_title": null,
        "status": null,
        "status_text": null,
        "auditor_name": null
      },
      "state_changes": [],
      "trusted_notary": null,
      "record_number": "REC-002",
      "record_code": "record_demo_code_002",
      "record_url": "https://example.com/records/record-demo-002",
      "submit_at": 1772256468,
      "submit_at_iso": "2026-02-28 13:27:48(UTC+08:00)",
      "submit_method": "扫一扫填写"
    }
  }
}

Record detail object

FieldTypeDescription
record_idintegerRecord ID
record_numberstringRecord number
record_codestringRecord code, unique identifier in the platform
record_urlstringRecord access URL
submit_atintegerSubmission Unix timestamp in seconds
submit_at_isostringFormatted submission time with timezone
submit_methodstringSubmission method
recorderobjectSubmitter info
projectobjectProject (partition) info
qrcodeobjectQR code info
orgobjectOrganization info
record_templateobjectForm template info
auditobjectApproval info
process_statusobjectProcessing status info
state_changesarrayTriggered state change list
trusted_notaryobject | nullLatest blockchain trusted notarization summary; returns null when no notarization data exists
tpl_groupsarrayGroups and field content in the record

Key nested objects

ObjectKey fieldsDescription
recorderauth_id, user_id, nameSubmitter info
projectid, name, numberProject info
qrcodeid, name, type, qrcode_urlQR code info
orgid, name, code, logo_urlOrganization info
record_templateid, name, type, numberForm template info
auditenabled, current_stage_id, statusApproval info
process_statusenabled, text, colorProcessing status
state_changes[]state, from_state_option, to_state_optionState change details
trusted_notarytx_hash, evidence_url, notarized_at, notarized_at_isoLatest blockchain trusted notarization summary

trusted_notary

Returns null when no notarization data exists.

When notarization data is available, returns the latest notarization summary:

json
{
  "tx_hash": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2",
  "evidence_url": "https://example.com/notary/2026/0407/13/evidence-demo-001.md",
  "notarized_at": 1775539953,
  "notarized_at_iso": "2026-04-07 13:32:33(UTC+08:00)"
}
FieldTypeDescription
tx_hashstringOn-chain notarization hash
evidence_urlstringURL of the source file for the latest notarization
notarized_atintegerLatest notarization Unix timestamp in seconds
notarized_at_isostringFormatted latest notarization time with timezone

tpl_groups[]

FieldTypeDescription
group_idintegerGroup ID
group_titlestringGroup title; empty string means no title
show_group_titlebooleanWhether to show the group title
is_page_break_groupbooleanWhether this is a page-break marker group. fields is usually an empty array for such groups
fieldsarrayList of fields in the group

tpl_groups[].fields[]

FieldTypeDescription
field_idintegerField ID
field_titlestringField title
field_descstringField description or hint text
field_typestringField type identifier; determines the structure of field_value
field_short_namestringField short name
group_idintegerParent group ID
field_valuemixedField value; format varies by field_type
optionsobjectDisplay options: is_result, is_highlight, is_hidden, is_masked

field_type and field_value

For a full overview of field names, categories, and naming conventions, see: Form component types overview.

When integrating with record/getRecord, read field_type first, then parse field_value accordingly. This section only covers what value structure each field type returns; the complete mapping is defined in content-json.schema.json (see the collapsible section above).

Categoryfield_typefield_value shape
Plain textname, tel, recorder, identity, job_number, text, textarea, date, time, customer_name, customer_mobile, customer_number, carnumberstring
Single choicesex, radioobject with option_text, option_id
Numbernumberobject with value, unit, unit_enabled
Multi choicecheckboxobject with values[]
Checklistchecklistarray of items with item_id, item_title, value
Matrixmatrixobject with columns[]
Dynamic matrixdynamic_matrixobject with rows[]
Locationaddressobject with address, lat, lng
Addressowner_addressobject with province, city, district, street, detail, full_address
Cascaded selectchained_selectsobject with values[]
Image / signatureimage, signaturearray of media objects
Audioaudioarray of items with url, size, duration, etc.
Videovideoarray of items with url, size, duration
Filefilearray of items with url, size, file_name
Descriptiondescriptionobject with description_html
OCRocr_*object with items[] and image
Subcode edit diffsub_qrcode_edit_diffarray of items with before_value, after_value

format=json-ld

When format=json-ld, data.data returns a Schema.org-style semantic object. Suitable for knowledge graphs, semantic search, or systems that need to preserve contextual semantics.

Companion files:

content-jsonld.schema.json (payload schema)
json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "content-jsonld.schema.json",
  "title": "record/getRecord content schema (format=json-ld)",
  "description": "`record/getRecord` 在 `format=json-ld` 时 `data.data` 的结构定义。该结构基于 Schema.org 风格输出,保留主字段约束并允许扩展属性。",
  "type": "object",
  "required": [
    "@context",
    "@type",
    "identifier",
    "name",
    "url",
    "mainEntity"
  ],
  "properties": {
    "@context": {
      "type": "string"
    },
    "@type": {
      "type": "string"
    },
    "identifier": {
      "type": "string"
    },
    "alternateName": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "dateCreated": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "author": {
      "type": "object"
    },
    "sourceOrganization": {
      "type": "object"
    },
    "isBasedOn": {
      "type": "object"
    },
    "isPartOf": {
      "type": "object"
    },
    "additionalProperty": {
      "type": "array"
    },
    "review": {
      "type": "object"
    },
    "potentialAction": {
      "type": "array"
    },
    "mainEntity": {
      "type": "object"
    }
  },
  "additionalProperties": true
}
Full examples
json
{
  "code": 0,
  "message": "ok",
  "data": {
    "format": "json-ld",
    "content_type": "application/ld+json; charset=utf-8",
    "data": {
      "@context": "https://schema.org",
      "@type": "CreativeWork",
      "identifier": "record-demo-001",
      "alternateName": "REC-001",
      "name": "设备巡检示例-REC-001",
      "url": "https://example.com/records/record-demo-001",
      "dateCreated": "2026-03-09 19:42:19(UTC+08:00)",
      "description": "扫一扫填写",
      "author": {
        "@type": "Person",
        "name": "张**",
        "identifier": "30001"
      },
      "sourceOrganization": {
        "@type": "Organization",
        "name": "示例企业",
        "identifier": "60001",
        "logo": "https://example.com/assets/logo-demo.png"
      },
      "isBasedOn": {
        "@type": "CreativeWork",
        "name": "设备巡检示例",
        "identifier": "70001",
        "description": "普通表单"
      },
      "isPartOf": {
        "@type": "CreativeWork",
        "name": "示例点位A",
        "identifier": "50001",
        "url": "https://example.com/qrcodes/qrcode-demo-001",
        "description": "普通二维码",
        "category_id": 50020
      },
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "分区",
          "value": "示例园区",
          "alternateName": "P001"
        },
        {
          "@type": "PropertyValue",
          "name": "处理进度",
          "value": "处理中"
        },
        {
          "@type": "PropertyValue",
          "name": "区块链可信存证",
          "value": {
            "tx_hash": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2",
            "evidence_url": "https://example.com/notary/2026/0407/13/evidence-demo-001.md",
            "notarized_at_iso": "2026-04-07 13:32:33(UTC+08:00)"
          }
        }
      ],
      "review": {
        "@type": "Review",
        "name": "厂长审批 - 审核通过",
        "reviewBody": "审核通过",
        "author": {
          "@type": "Person",
          "name": "张**"
        },
        "current_stage_id": 20242
      },
      "potentialAction": [
        {
          "@type": "Action",
          "name": "检查状态",
          "description": "正常 -> 正常"
        },
        {
          "@type": "Action",
          "name": "巡逻结果",
          "description": "正常 -> 异常"
        }
      ],
      "mainEntity": {
        "@type": "ItemList",
        "name": "组件数据",
        "numberOfItems": 34,
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "item": {
              "@type": "PropertyValue",
              "name": "巡检人姓名",
              "value": "黄**"
            }
          },
          {
            "@type": "ListItem",
            "position": 2,
            "item": {
              "@type": "PropertyValue",
              "name": "巡检人手机号",
              "value": "136****9379"
            }
          },
          {
            "@type": "ListItem",
            "position": 3,
            "item": {
              "@type": "PropertyValue",
              "name": "巡检人微信名",
              "value": "黄**"
            }
          },
          {
            "@type": "ListItem",
            "position": 4,
            "item": {
              "@type": "PropertyValue",
              "name": "巡检人身份证号",
              "value": "3604************17"
            }
          },
          {
            "@type": "ListItem",
            "position": 5,
            "item": {
              "@type": "PropertyValue",
              "name": "巡检人工号",
              "value": "NO-1001"
            }
          },
          {
            "@type": "ListItem",
            "position": 6,
            "item": {
              "@type": "PropertyValue",
              "name": "巡检人性别",
              "value": "男"
            }
          },
          {
            "@type": "ListItem",
            "position": 7,
            "item": {
              "@type": "PropertyValue",
              "name": "巡检内容",
              "value": "灭火器"
            }
          },
          {
            "@type": "ListItem",
            "position": 8,
            "item": {
              "@type": "PropertyValue",
              "name": "巡检描述",
              "value": "看看园区的灭火器是不是正常运行"
            }
          },
          {
            "@type": "ListItem",
            "position": 9,
            "item": {
              "@type": "QuantitativeValue",
              "name": "当前温度",
              "value": 30.6,
              "unitText": "摄氏度"
            }
          },
          {
            "@type": "ListItem",
            "position": 10,
            "item": {
              "@type": "QuantitativeValue",
              "name": "巡检次数",
              "value": 96
            }
          },
          {
            "@type": "ListItem",
            "position": 11,
            "item": {
              "@type": "ItemList",
              "name": "灭火器检查",
              "itemListElement": [
                {
                  "@type": "ListItem",
                  "position": 1,
                  "name": "压力正常",
                  "item": {
                    "@type": "PropertyValue",
                    "name": "压力正常",
                    "value": "正常",
                    "description": "压力表显示正常",
                    "image": {
                      "@type": "ImageObject",
                      "contentUrl": "https://example.com/assets/image-demo-010.jpg",
                      "width": 640,
                      "height": 854,
                      "uploadDate": "2026-02-27 10:31:31(UTC+08:00)"
                    }
                  }
                },
                {
                  "@type": "ListItem",
                  "position": 2,
                  "name": "外观完好",
                  "item": {
                    "@type": "PropertyValue",
                    "name": "外观完好",
                    "value": "异常",
                    "description": "生锈了,可能有隐患",
                    "image": {
                      "@type": "ImageObject",
                      "contentUrl": "https://example.com/assets/image-demo-011.jpg",
                      "width": 640,
                      "height": 854,
                      "uploadDate": "2026-02-27 10:31:56(UTC+08:00)"
                    }
                  }
                },
                {
                  "@type": "ListItem",
                  "position": 3,
                  "name": "配件齐全",
                  "item": {
                    "@type": "PropertyValue",
                    "name": "配件齐全",
                    "value": "需要关注",
                    "description": "很多东西放的很乱"
                  }
                },
                {
                  "@type": "ListItem",
                  "position": 4,
                  "name": "有效期内",
                  "item": {
                    "@type": "PropertyValue",
                    "name": "有效期内",
                    "value": "正常"
                  }
                },
                {
                  "@type": "ListItem",
                  "position": 5,
                  "name": "放置位置正确",
                  "item": {
                    "@type": "PropertyValue",
                    "name": "放置位置正确",
                    "value": "正常"
                  }
                }
              ]
            }
          },
          {
            "@type": "ListItem",
            "position": 12,
            "item": {
              "@type": "PropertyValue",
              "name": "同行人信息",
              "value": [
                {
                  "@type": "PropertyValue",
                  "name": "姓名",
                  "value": "张*"
                },
                {
                  "@type": "PropertyValue",
                  "name": "手机号",
                  "value": "134****3002"
                },
                {
                  "@type": "PropertyValue",
                  "name": "性别",
                  "value": "女"
                },
                {
                  "@type": "PropertyValue",
                  "name": "身份证",
                  "value": "3604************17"
                },
                {
                  "@type": "PropertyValue",
                  "name": "年龄",
                  "value": "18"
                }
              ]
            }
          },
          {
            "@type": "ListItem",
            "position": 13,
            "item": {
              "@type": "ItemList",
              "name": "检查具体内容项",
              "itemListElement": [
                {
                  "@type": "ListItem",
                  "position": 1,
                  "item": [
                    {
                      "@type": "PropertyValue",
                      "name": "物品名称",
                      "value": "电源适配器"
                    },
                    {
                      "@type": "PropertyValue",
                      "name": "物品厂家地址",
                      "value": "天津市天津市滨海新区大港街道一号路交口县"
                    },
                    {
                      "@type": "PropertyValue",
                      "name": "生成日期",
                      "value": "2026年02月27日"
                    }
                  ]
                },
                {
                  "@type": "ListItem",
                  "position": 2,
                  "item": [
                    {
                      "@type": "PropertyValue",
                      "name": "物品名称",
                      "value": "办公桌"
                    },
                    {
                      "@type": "PropertyValue",
                      "name": "物品厂家地址",
                      "value": "山西省大同市南郊区马军营乡黄家村"
                    },
                    {
                      "@type": "PropertyValue",
                      "name": "生成日期",
                      "value": "2026年02月02日"
                    }
                  ]
                }
              ]
            }
          },
          {
            "@type": "ListItem",
            "position": 14,
            "item": {
              "@type": "PropertyValue",
              "name": "巡检日期",
              "value": "2026年02月27日 10时30分"
            }
          },
          {
            "@type": "ListItem",
            "position": 15,
            "item": {
              "@type": "PropertyValue",
              "name": "巡检时间",
              "value": "2026-02-27 10:30"
            }
          },
          {
            "@type": "ListItem",
            "position": 16,
            "item": {
              "@type": "PropertyValue",
              "name": "设备情况",
              "value": "正常"
            }
          },
          {
            "@type": "ListItem",
            "position": 17,
            "item": {
              "@type": "PropertyValue",
              "name": "环境情况",
              "value": "其他[不是很干净]"
            }
          },
          {
            "@type": "ListItem",
            "position": 18,
            "item": {
              "@type": "PropertyValue",
              "name": "消耗工具",
              "value": "螺丝刀,扳手,润滑油,其他[矿泉水瓶]"
            }
          },
          {
            "@type": "ListItem",
            "position": 19,
            "item": {
              "@type": "PropertyValue",
              "name": "负责人姓名",
              "value": "黄**"
            }
          },
          {
            "@type": "ListItem",
            "position": 20,
            "item": {
              "@type": "PropertyValue",
              "name": "负责人手机号",
              "value": "136****9379"
            }
          },
          {
            "@type": "ListItem",
            "position": 21,
            "item": {
              "@type": "Place",
              "name": "设备定位",
              "address": "示例省示例市示例区示例路100号",
              "geo": {
                "@type": "GeoCoordinates",
                "latitude": 30.123456,
                "longitude": 120.123456
              }
            }
          },
          {
            "@type": "ListItem",
            "position": 22,
            "item": {
              "@type": "PostalAddress",
              "name": "安装地址",
              "addressRegion": "示例省",
              "addressLocality": "示例市",
              "addressCountry": "示例区",
              "streetAddress": "示例街道示例路100号",
              "description": "示例省示例市示例区示例镇示例地点"
            }
          },
          {
            "@type": "ListItem",
            "position": 23,
            "item": {
              "@type": "PropertyValue",
              "name": "运输车辆车牌",
              "value": "浙B9X8L5"
            }
          },
          {
            "@type": "ListItem",
            "position": 24,
            "item": {
              "@type": "ImageObject",
              "contentUrl": "https://example.com/assets/image-demo-012.jpg",
              "width": 1000,
              "height": 558,
              "contentSize": "5915",
              "uploadDate": "2026-02-27 10:38:02(UTC+08:00)",
              "name": "负责人手写签名"
            }
          },
          {
            "@type": "ListItem",
            "position": 25,
            "item": {
              "@type": "PropertyValue",
              "name": "培训学校",
              "value": "浙江省/杭州市/下城区/学校1"
            }
          },
          {
            "@type": "ListItem",
            "position": 26,
            "item": {
              "@type": "PropertyValue",
              "name": "补充图片",
              "value": [
                {
                  "@type": "ImageObject",
                  "contentUrl": "https://example.com/assets/image-demo-013.jpg",
                  "width": 1080,
                  "height": 1920,
                  "contentSize": "298958",
                  "uploadDate": "2026-02-27 10:35:10(UTC+08:00)"
                },
                {
                  "@type": "ImageObject",
                  "contentUrl": "https://example.com/assets/image-demo-014.jpg",
                  "width": 1080,
                  "height": 1920,
                  "contentSize": "311779",
                  "uploadDate": "2026-02-27 10:35:10(UTC+08:00)"
                }
              ]
            }
          },
          {
            "@type": "ListItem",
            "position": 27,
            "item": {
              "@type": "AudioObject",
              "contentUrl": "https://example.com/assets/audio-demo-004.mp3",
              "duration": "PT4.48S",
              "uploadDate": "2026-02-27 10:35:19(UTC+08:00)",
              "name": "补充录音"
            }
          },
          {
            "@type": "ListItem",
            "position": 28,
            "item": {
              "@type": "PropertyValue",
              "name": "补充文件",
              "value": [
                {
                  "@type": "DigitalDocument",
                  "contentUrl": "https://example.com/assets/file-demo-004.pdf",
                  "name": "第七单元练练吧.pdf",
                  "contentSize": "2179410",
                  "uploadDate": "2026-02-27 10:35:32(UTC+08:00)"
                },
                {
                  "@type": "DigitalDocument",
                  "contentUrl": "https://example.com/assets/file-demo-005.docx",
                  "name": "1月23日.docx",
                  "contentSize": "435177",
                  "uploadDate": "2026-02-27 10:35:41(UTC+08:00)"
                }
              ]
            }
          },
          {
            "@type": "ListItem",
            "position": 29,
            "item": {
              "@type": "VideoObject",
              "contentUrl": "https://example.com/assets/video-demo-004.mp4",
              "duration": "PT6S",
              "contentSize": "418619",
              "uploadDate": "2026-02-27 10:35:56(UTC+08:00)",
              "name": "补充视频"
            }
          },
          {
            "@type": "ListItem",
            "position": 30,
            "item": {
              "@type": "PropertyValue",
              "name": "填表时请注意以下说明",
              "value": "设备巡检示例旨在通过定期、标准化的外观、功能及性能检查,及时发现并消除安全隐患,确保设备高效安全运行。巡检应严格遵循计划,采用视觉、听觉、触觉及辅助工具(如测温仪)对关键部件进行“五感”检查,并对运行参数(如压力、振动)做真实记录,发现异常及时上报。"
            }
          },
          {
            "@type": "ListItem",
            "position": 31,
            "item": {
              "@type": "PropertyValue",
              "name": "卖家身份证信息",
              "value": [
                {
                  "@type": "PropertyValue",
                  "name": "身份证号",
                  "value": "4403************27"
                },
                {
                  "@type": "PropertyValue",
                  "name": "姓名",
                  "value": "黄**"
                },
                {
                  "@type": "PropertyValue",
                  "name": "性别",
                  "value": "女"
                },
                {
                  "@type": "PropertyValue",
                  "name": "民族",
                  "value": "汉"
                },
                {
                  "@type": "PropertyValue",
                  "name": "出生日期",
                  "value": "2018年05月18日"
                },
                {
                  "@type": "PropertyValue",
                  "name": "地址",
                  "value": "示例省示例市示例区示例街道示例小区1号"
                }
              ]
            }
          },
          {
            "@type": "ListItem",
            "position": 32,
            "item": {
              "@type": "PropertyValue",
              "name": "营业执照信息",
              "value": [
                {
                  "@type": "PropertyValue",
                  "name": "统一社会信用代码",
                  "value": "92371725MAELLWBE8H"
                },
                {
                  "@type": "PropertyValue",
                  "name": "企业名称",
                  "value": "郓城县森兰服装厂(个体工商户)"
                },
                {
                  "@type": "PropertyValue",
                  "name": "类型",
                  "value": "个体工商户"
                },
                {
                  "@type": "PropertyValue",
                  "name": "营业场所/住所",
                  "value": "示例省示例市示例区示例街道66号"
                },
                {
                  "@type": "PropertyValue",
                  "name": "法人/负责人",
                  "value": "钱**"
                },
                {
                  "@type": "PropertyValue",
                  "name": "经营范围",
                  "value": "一般项目:服装制造:服装服饰批发:服装服饰零售。(除依法须经批准的项目外,凭营业执照依法自主开展经营活动)"
                },
                {
                  "@type": "PropertyValue",
                  "name": "注册资本",
                  "value": "99999"
                },
                {
                  "@type": "PropertyValue",
                  "name": "营业期限",
                  "value": "2018"
                },
                {
                  "@type": "PropertyValue",
                  "name": "统一社会信用代码",
                  "value": "92371725MAELLWBE8H"
                },
                {
                  "@type": "PropertyValue",
                  "name": "格式化营业期限起始日期",
                  "value": "2025年05月29日"
                },
                {
                  "@type": "PropertyValue",
                  "name": "格式化营业期限终止日期",
                  "value": "2026年02月27日"
                },
                {
                  "@type": "PropertyValue",
                  "name": "组成形式",
                  "value": "个人经营"
                },
                {
                  "@type": "PropertyValue",
                  "name": "发照日期",
                  "value": "2025年05月29日"
                },
                {
                  "@type": "PropertyValue",
                  "name": "证照标题",
                  "value": "营业执照"
                }
              ],
              "image": {
                "@type": "ImageObject",
                "contentUrl": "https://example.com/assets/image-demo-015.jpg",
                "width": 1080,
                "height": 1920,
                "uploadDate": "2026-02-27 10:37:03(UTC+08:00)"
              }
            }
          },
          {
            "@type": "ListItem",
            "position": 33,
            "item": {
              "@type": "PropertyValue",
              "name": "电表读数",
              "value": [
                {
                  "@type": "PropertyValue",
                  "name": "度数",
                  "value": "6690.8",
                  "unitText": "度"
                }
              ],
              "image": {
                "@type": "ImageObject",
                "contentUrl": "https://example.com/assets/image-demo-016.jpg",
                "width": 1080,
                "height": 1920,
                "uploadDate": "2026-02-27 10:37:40(UTC+08:00)"
              }
            }
          },
          {
            "@type": "ListItem",
            "position": 34,
            "item": {
              "@type": "PropertyValue",
              "name": "产品编号",
              "value": "PRD-0001"
            }
          }
        ]
      }
    }
  }
}
json
{
  "code": 0,
  "message": "ok",
  "data": {
    "format": "json-ld",
    "content_type": "application/ld+json; charset=utf-8",
    "data": {
      "@context": "https://schema.org",
      "@type": "CreativeWork",
      "identifier": "record-demo-002",
      "alternateName": "REC-002",
      "name": "子码编辑记录示例-REC-002",
      "url": "https://example.com/records/record-demo-002",
      "dateCreated": "2026-02-28 13:27:48(UTC+08:00)",
      "description": "扫一扫填写",
      "author": {
        "@type": "Person",
        "name": "张**",
        "identifier": "30001"
      },
      "sourceOrganization": {
        "@type": "Organization",
        "name": "示例企业",
        "identifier": "60001",
        "logo": "https://example.com/assets/logo-demo.png"
      },
      "isBasedOn": {
        "@type": "CreativeWork",
        "name": "子码编辑记录示例",
        "identifier": "70002",
        "description": "子码编辑记录系统表单"
      },
      "isPartOf": {
        "@type": "CreativeWork",
        "name": "示例子码A",
        "identifier": "50002",
        "url": "https://example.com/qrcodes/qrcode-demo-002",
        "description": "批量模板子码",
        "category_id": 50021
      },
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "分区",
          "value": "示例园区",
          "alternateName": "P001"
        }
      ],
      "mainEntity": {
        "@type": "ItemList",
        "name": "组件数据",
        "numberOfItems": 2,
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "item": {
              "@type": "ItemList",
              "name": "修改内容",
              "numberOfItems": 11,
              "itemListElement": [
                {
                  "@type": "ListItem",
                  "position": 1,
                  "item": {
                    "@type": "PropertyValue",
                    "name": "编号",
                    "value": "NO-1001 → SUB-1001"
                  }
                },
                {
                  "@type": "ListItem",
                  "position": 2,
                  "item": {
                    "@type": "PropertyValue",
                    "name": "设备描述",
                    "value": "标准的灭火器 → 标准的灭火器,都是好的"
                  }
                },
                {
                  "@type": "ListItem",
                  "position": 3,
                  "item": {
                    "@type": "PropertyValue",
                    "name": "数量",
                    "value": "10 → 100"
                  }
                },
                {
                  "@type": "ListItem",
                  "position": 4,
                  "item": {
                    "@type": "PropertyValue",
                    "name": "生产日期",
                    "value": "2026-02-28 → 2026-05-28 00:00"
                  }
                },
                {
                  "@type": "ListItem",
                  "position": 5,
                  "item": {
                    "@type": "PropertyValue",
                    "name": "当前状态",
                    "value": "正常 → 异常"
                  }
                },
                {
                  "@type": "ListItem",
                  "position": 6,
                  "item": {
                    "@type": "PropertyValue",
                    "name": "包含附件",
                    "value": "喷嘴,水管,其他(螺丝) → 喷嘴,其他(老虎钳)"
                  }
                },
                {
                  "@type": "ListItem",
                  "position": 7,
                  "item": {
                    "@type": "PropertyValue",
                    "name": "设备定位",
                    "value": "示例地点A → 示例地点B"
                  }
                },
                {
                  "@type": "ListItem",
                  "position": 8,
                  "item": {
                    "@type": "PropertyValue",
                    "name": "现场照片",
                    "value": [
                      {
                        "@type": "PropertyValue",
                        "name": "修改前",
                        "value": [
                          {
                            "@type": "ImageObject",
                            "contentUrl": "https://example.com/assets/image-demo-018.jpg",
                            "width": 1080,
                            "height": 1851,
                            "contentSize": "141122"
                          }
                        ]
                      },
                      {
                        "@type": "PropertyValue",
                        "name": "修改后",
                        "value": [
                          {
                            "@type": "ImageObject",
                            "contentUrl": "https://example.com/assets/image-demo-019.jpg",
                            "width": 640,
                            "height": 854,
                            "contentSize": "57778"
                          }
                        ]
                      }
                    ]
                  }
                },
                {
                  "@type": "ListItem",
                  "position": 9,
                  "item": {
                    "@type": "PropertyValue",
                    "name": "说明文件",
                    "value": [
                      {
                        "@type": "PropertyValue",
                        "name": "修改前",
                        "value": [
                          {
                            "@type": "DigitalDocument",
                            "contentUrl": "https://example.com/assets/file-demo-006.xlsx",
                            "name": "办公室巡查_D542_二维码统计.xlsx",
                            "contentSize": "5280"
                          }
                        ]
                      },
                      {
                        "@type": "PropertyValue",
                        "name": "修改后",
                        "value": [
                          {
                            "@type": "DigitalDocument",
                            "contentUrl": "https://example.com/assets/file-demo-007.pdf",
                            "name": "第七单元练练吧.pdf",
                            "contentSize": "2179410"
                          }
                        ]
                      }
                    ]
                  }
                },
                {
                  "@type": "ListItem",
                  "position": 10,
                  "item": {
                    "@type": "PropertyValue",
                    "name": "操作指南",
                    "value": [
                      {
                        "@type": "PropertyValue",
                        "name": "修改前",
                        "value": [
                          {
                            "@type": "AudioObject",
                            "contentUrl": "https://example.com/assets/audio-demo-005.mp3",
                            "duration": "PT4M51.96S"
                          }
                        ]
                      },
                      {
                        "@type": "PropertyValue",
                        "name": "修改后",
                        "value": [
                          {
                            "@type": "AudioObject",
                            "contentUrl": "https://example.com/assets/audio-demo-006.mp3",
                            "duration": "PT4.04S"
                          }
                        ]
                      }
                    ]
                  }
                },
                {
                  "@type": "ListItem",
                  "position": 11,
                  "item": {
                    "@type": "PropertyValue",
                    "name": "操作视频",
                    "value": [
                      {
                        "@type": "PropertyValue",
                        "name": "修改前",
                        "value": [
                          {
                            "@type": "VideoObject",
                            "contentUrl": "https://example.com/assets/video-demo-005.mp4",
                            "duration": "PT5.44S",
                            "contentSize": "224532"
                          }
                        ]
                      },
                      {
                        "@type": "PropertyValue",
                        "name": "修改后",
                        "value": [
                          {
                            "@type": "VideoObject",
                            "contentUrl": "https://example.com/assets/video-demo-006.mp4",
                            "duration": "PT3S",
                            "contentSize": "217204"
                          }
                        ]
                      }
                    ]
                  }
                }
              ]
            }
          },
          {
            "@type": "ListItem",
            "position": 2,
            "item": {
              "@type": "Place",
              "name": "操作地点",
              "address": "示例省示例市示例区示例路100号",
              "geo": {
                "@type": "GeoCoordinates",
                "latitude": 30.123456,
                "longitude": 120.123456
              }
            }
          }
        ]
      }
    }
  }
}

format=markdown

When format=markdown, data.data returns a full Markdown text, suitable for display, archive export, or LLM-based reading tasks.

Companion files:

content-markdown.schema.json (payload schema)
json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "content-markdown.schema.json",
  "title": "record/getRecord content schema (format=markdown)",
  "description": "`record/getRecord` 在 `format=markdown` 时 `data.data` 的结构定义。返回值为完整 Markdown 文本。",
  "type": "string"
}
Full examples
json
{
  "code": 0,
  "message": "ok",
  "data": {
    "format": "markdown",
    "content_type": "text/markdown; charset=utf-8",
    "data": "---\ntitle: 设备巡检示例-REC-001\nrecord_id: 10001\nrecord_number: REC-001\nrecord_code: record_demo_code_001\nrecord_url: \"https://example.com/records/record-demo-001\"\nsubmit_at_iso: \"2026-03-09 19:42:19(UTC+08:00)\"\nsubmit_at: 1773056539\nsubmit_method: API提交\nrecorder_name: 张**\norg_name: 示例企业\nproject_name: 示例园区\nproject_number: P001\nqrcode_name: 示例点位A\nqrcode_url: \"https://example.com/qrcodes/qrcode-demo-001\"\nrecord_template_name: 设备巡检示例\nrecord_template_type: 0\nprocess_status: 处理中\n---\n\n# 设备巡检示例-REC-001\n\n## 基本信息\n\n**记录编号:** REC-001\n\n**提交方式:** API提交\n\n**提交时间:** 2026-03-09 19:42:19(UTC+08:00)\n\n**填表人:** 张**\n\n**码链接:** https://example.com/qrcodes/qrcode-demo-001\n\n**记录链接:** https://example.com/records/record-demo-001\n\n**处理进度:** 处理中\n\n---\n\n## 关联信息\n\n**组织:** 示例企业\n\n**分区:** 示例园区(P001)\n\n**二维码:** 示例点位A\n\n**表单:** 设备巡检示例(TPL-001)\n\n---\n\n## 触发状态变更\n\n| 状态名称 | 变更前 | 变更后 |\n| --- | --- | --- |\n| 检查状态 | 正常 | 正常 |\n| 巡逻结果 | 异常 | 异常 |\n\n---\n\n## 组件信息\n\n### 巡检人基本信息\n\n**巡检人姓名:** 张**\n\n**巡检人手机号:** 136****9379\n\n**巡检人微信名:** 张**\n\n**巡检人身份证号:** 360425199****15517\n\n**巡检人工号:** NO-1001\n\n**巡检人性别:** 男\n\n---\n\n### 巡检内容\n\n**巡检内容:** 灭火器\n\n**巡检描述:** 灭火器正常摆放\n\n**当前温度:** 30.6摄氏度\n\n**巡检次数:** 96\n\n**灭火器检查:**\n\n<table><thead><tr><th>项目</th><th>结果</th><th>描述</th></tr></thead><tbody><tr><td>压力正常</td><td><strong>正常</strong></td><td></td></tr><tr><td>外观完好</td><td><strong>异常</strong></td><td>生锈了,需要注意</td></tr><tr><td>配件齐全</td><td><strong>需要关注</strong></td><td>不多不少刚刚好</td></tr><tr><td>有效期内</td><td><strong>正常</strong></td><td></td></tr><tr><td>放置位置正确</td><td><strong>正常</strong></td><td></td></tr></tbody></table>\n\n**同行人信息:**\n\n<table><tbody><tr><td><strong>姓名</strong></td><td>张**</td></tr><tr><td><strong>手机号</strong></td><td>136****9379</td></tr><tr><td><strong>性别</strong></td><td>男</td></tr><tr><td><strong>身份证</strong></td><td>360425199****15517</td></tr><tr><td><strong>年龄</strong></td><td>66</td></tr><tr><td><strong>婚姻状况</strong></td><td>已婚</td></tr></tbody></table>\n\n**检查具体内容项:**\n\n<table><thead><tr><th>物品名称</th><th>物品厂家地址</th><th>生成日期</th><th>单位</th></tr></thead><tbody><tr><td>螺丝</td><td>示例省示例市示例区示例街道A</td><td>2026年03月12日</td><td>箱</td></tr><tr><td>扳手</td><td>示例省示例市示例区示例街道B</td><td>2026年03月27日</td><td>其他[枚]</td></tr></tbody></table>\n\n**巡检日期:** 2026年03月09日 17时24分\n\n**巡检时间:** 2026-03-09 17:24\n\n**是否需要报销:** 不需要\n\n**设备情况:** 其他[一点小问题]\n\n**环境情况:** 正常\n\n**消耗工具:** 螺丝刀,扳手,万用表,其他[电线杆子]\n\n---\n\n### 负责人信息\n\n**负责人姓名:** 李**\n\n**负责人手机号:** 136****9379\n\n**设备定位:** 示例省示例市示例区示例路100号(30.123456, 120.123456)\n\n**安装地址:** 示例省示例市示例区示例街道示例地点\n\n**运输车辆车牌:** 京A1***5\n\n**负责人手写签名:** [查看图片](https://example.com/assets/image-demo-signature.png)\n\n**培训学校:** 浙江省/杭州市/下城区/学校1\n\n---\n\n### 其他补充材料\n\n**补充图片:** [查看图片 1](https://example.com/assets/image-demo-010.jpg)、[查看图片 2](https://example.com/assets/image-demo-011.jpg)\n\n**补充录音:** [下载音频](https://example.com/assets/audio-demo-010.mp3)\n\n**补充文件:** [下载文件](https://example.com/assets/file-demo-010.pdf)\n\n**补充视频:** [下载视频](https://example.com/assets/video-demo-010.mp4)\n\n---\n\n### 操作说明\n\n**填表时请注意以下说明:**\n\n<p><span>设备巡检示例旨在通过定期、标准化的外观、功能及性能检查,及时发现并消除安全隐患,确保设备高效安全运行。巡检应严格遵循计划,采用视觉、听觉、触觉及辅助工具(如测温仪)对关键部件进行“五感”检查,并对运行参数(如压力、振动)做真实记录,发现异常及时上报。</span></p><p><span><span></span></span><img src=\"https://example.com/assets/image-demo-020.jpeg\"></p>\n\n**卖家身份证信息:**\n\n<table><tbody><tr><td><strong>身份证号</strong></td><td>4403**********3527</td></tr><tr><td><strong>姓名</strong></td><td>王**</td></tr><tr><td><strong>性别</strong></td><td>女</td></tr><tr><td><strong>民族</strong></td><td>汉</td></tr><tr><td><strong>出生日期</strong></td><td>2018年05月18日</td></tr><tr><td><strong>地址</strong></td><td>示例省示例市示例区示例街道示例小区1号</td></tr></tbody></table>\n\n---\n\n### 其他信息\n\n**营业执照信息:**\n\n<table><tbody><tr><td><strong>统一社会信用代码</strong></td><td>_(示例中省略)_</td></tr><tr><td><strong>企业名称</strong></td><td>_(示例中省略)_</td></tr><tr><td><strong>类型</strong></td><td>_(示例中省略)_</td></tr><tr><td><strong>营业场所/住所</strong></td><td>_(示例中省略)_</td></tr><tr><td><strong>法人/负责人</strong></td><td>_(示例中省略)_</td></tr><tr><td><strong>经营范围</strong></td><td>_(示例中省略)_</td></tr><tr><td><strong>注册资本</strong></td><td>_(示例中省略)_</td></tr><tr><td><strong>营业期限</strong></td><td>_(示例中省略)_</td></tr><tr><td><strong>统一社会信用代码</strong></td><td>_(示例中省略)_</td></tr><tr><td><strong>格式化营业期限起始日期</strong></td><td>_(示例中省略)_</td></tr><tr><td><strong>格式化营业期限终止日期</strong></td><td>_(示例中省略)_</td></tr><tr><td><strong>组成形式</strong></td><td>_(示例中省略)_</td></tr><tr><td><strong>发照日期</strong></td><td>_(示例中省略)_</td></tr><tr><td><strong>证照标题</strong></td><td>_(示例中省略)_</td></tr></tbody></table>\n\n**电表读数:**\n\n<table><tbody><tr><td><strong>度数</strong></td><td>10890.1度</td></tr></tbody></table>\n\n**产品编号:** PRD-0001\n\n---\n\n## 区块链可信存证\n\n**存证哈希:** a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2\n\n**存证源文件:** [查看存证文件](https://example.com/notary/2026/0407/13/evidence-demo-001.md)\n\n**存证时间:** 2026-04-07 13:32:33(UTC+08:00)\n"
  }
}
json
{
  "code": 0,
  "message": "ok",
  "data": {
    "format": "markdown",
    "content_type": "text/markdown; charset=utf-8",
    "data": "---\ntitle: 子码编辑记录示例-REC-002\nrecord_id: 10002\nrecord_number: REC-002\nrecord_code: record_demo_code_002\nrecord_url: \"https://example.com/records/record-demo-002\"\nsubmit_at_iso: \"2026-02-28 13:27:48(UTC+08:00)\"\nsubmit_at: 1772256468\nsubmit_method: 扫一扫填写\nrecorder_name: 张**\norg_name: 示例企业\nproject_name: 示例园区\nproject_number: P001\nqrcode_name: SUB-1001\nqrcode_url: \"https://example.com/qrcodes/qrcode-demo-002\"\nrecord_template_name: 子码编辑记录示例\nrecord_template_type: 13\n---\n\n# 子码编辑记录示例-REC-002\n\n## 基本信息\n\n**记录编号:** REC-002\n\n**提交方式:** 扫一扫填写\n\n**提交时间:** 2026-02-28 13:27:48(UTC+08:00)\n\n**填表人:** 张**\n\n**码链接:** https://example.com/qrcodes/qrcode-demo-002\n\n**记录链接:** https://example.com/records/record-demo-002\n\n---\n\n## 关联信息\n\n**组织:** 示例企业\n\n**分区:** 示例园区(P001)\n\n**二维码:** SUB-1001\n\n---\n\n## 组件信息\n\n**修改内容:**\n\n**编号:** NO-1001 → SUB-1001\n\n**设备描述:** 标准的灭火器 → 标准的灭火器,都是好的\n\n**数量:** 10 → 100\n\n**生产日期:** 2026-02-28 → 2026-05-28 00:00\n\n**当前状态:** 正常 → 异常\n\n**包含附件:** 喷嘴,水管,其他(螺丝) → 喷嘴,其他(老虎钳)\n\n**设备定位:** 示例地点A → 示例地点B\n\n**现场照片:**\n\n<table><tbody><tr><td><strong>修改前</strong></td><td><a href=\"https://example.com/assets/image-demo-021.jpg\"><img src=\"https://example.com/assets/image-demo-022.jpg\" width=\"180\"></a></td></tr><tr><td><strong>修改后</strong></td><td><a href=\"https://example.com/assets/image-demo-023.jpg\"><img src=\"https://example.com/assets/image-demo-024.jpg\" width=\"180\"></a></td></tr></tbody></table>\n\n**说明文件:**\n\n<table><tbody><tr><td><strong>修改前</strong></td><td>[办公室巡查_D542_二维码统计.xlsx](https://example.com/assets/file-demo-008.xlsx)</td></tr><tr><td><strong>修改后</strong></td><td>[第七单元练练吧.pdf](https://example.com/assets/file-demo-009.pdf)</td></tr></tbody></table>\n\n**操作指南:**\n\n<table><tbody><tr><td><strong>修改前</strong></td><td><a href=\"https://example.com/assets/audio-demo-007.mp3\"><audio controls src=\"https://example.com/assets/audio-demo-008.mp3\"></audio></a></td></tr><tr><td><strong>修改后</strong></td><td><a href=\"https://example.com/assets/audio-demo-009.mp3\"><audio controls src=\"https://example.com/assets/audio-demo-010.mp3\"></audio></a></td></tr></tbody></table>\n\n**操作视频:**\n\n<table><tbody><tr><td><strong>修改前</strong></td><td><a href=\"https://example.com/assets/video-demo-007.mp4\"><video controls width=\"320\" src=\"https://example.com/assets/video-demo-008.mp4\"></video></a></td></tr><tr><td><strong>修改后</strong></td><td><a href=\"https://example.com/assets/video-demo-009.mp4\"><video controls width=\"320\" src=\"https://example.com/assets/video-demo-010.mp4\"></video></a></td></tr></tbody></table>\n\n**操作地点:** 示例省示例市示例区示例路100号(30.123456, 120.123456)\n"
  }
}

Other conventions

Null values

CaseRule
Field not filledfield_value may return null
Related entity does not existStructure remains unchanged, but nested field values may be null
String field with no contentUsually returns empty string ""
Array field with no contentUsually returns empty array []

Masking

CaseDescription
Live API responseWhether data is masked depends on the org's authorization and output configuration
Doc example filesAll example files linked in this document are sanitized, for structure reference and integration testing only
tpl_groups[].fields[].options.is_maskedIndicates whether the masking toggle is enabled for the field; does not guarantee the current response value is masked

AI image audit fields

The following image objects may contain an optional ai_audit_result object:

  • field_value[] items of image / signature
  • value.images[] in checklists
  • image in OCR
  • media_items[] in subcode edit diff
FieldTypeDescription
ai_audit_result.audit_statusinteger0 default, 1 pass, 2 fail, 3 error, 4 pending
ai_audit_result.audit_status_textstringChinese label for audit_status
ai_audit_result.reasonstringReason text returned by AI

Error response

On failure, a non-success status is typically returned. The response body may contain the following fields:

json
{
  "code": 400,
  "error_code": 100300,
  "message": "System error",
  "message_detail": ""
}
FieldTypeDescription
codeintegerHTTP status code or platform error status
error_codeintegerBusiness error code
messagestringError summary
message_detailstringDetailed error message; may be empty string

For error code definitions, see: Error codes.