Caoliao Open Platform

English

简体中文

English

简体中文

Theme

Query forms and records linked to a QR code ​

Use this flow when you only have QR coding or a QR URL and want to find:

  • which forms are linked to this QR code
  • the field structure of a target form
  • records already submitted under this QR code

Preconditions ​

Step 1: Get code_id ​

Call QR code content. Read data.meta.id as code_id for subsequent calls.

Step 2: Get linked tpl_id ​

Call QR code operation elements, filter elements with element_type=2, and get one or more tpl_id values.

Step 3: Read form structure as needed ​

If you need form title, fields, options, or component types, call Get form template.

Typical purposes:

  • dynamic form rendering
  • backend field mapping validation
  • preparing structured IDs (field_id, option_id, ...)

Step 4: Query record list ​

Call Get records. Recommended filters:

GoalSuggested parameters
All records under this QR codefilters.qrcode.id=code_id
Records for one form under this QR codefilters.qrcode.id=code_id + filters.record_template.id=tpl_id
Records for one form in current API-key scopefilters.record_template.id=tpl_id
Global search in current API-key scopeOmit both filters; add keyword/time filters as needed

Step 5: Whether to call single-record API ​

When format=json, each item in getRecords.data.list[] is already a full record object.

Call Get a single record only when you need precise retrieval by one record_id / record_url.

Key ID mapping ​

NameSourceUsage
code_idqrcodes/getContent -> data.meta.idTarget QR code
tpl_idqrcodes/getOperation where element_type=2Target form template
record_idgetRecords.data.list[] or business contextRetrieve one exact record

Common notes ​

  • One QR code can link to multiple forms; do not assume a single tpl_id.
  • getRecords already returns full detail in json mode; avoid per-item getRecord calls for batch reads.
  • If filters.qrcode.id is omitted, results usually expand to the API-key visible scope.