Skip to content

Data version

A data version identifies a particular state of data. Whether identifiers encode a sequence must be defined; a schema version is a different concept.

Also known asRecord version
APIs & Integration

A data version identifies a particular state of data, such as a revision of a product record. It must be distinguished from the version of the data schema or API. An unchanged schema can permit many different data states.

Assess the data state using its revision

In a fictional ERP, revisions are numbered sequentially for each product. Revision 8 reaches the receiver before an older message with revision 7. Later arrival does not make its content newer. The integration needs a rule for which state may be adopted.

Interpret the identifier according to its agreement

Not every version identifier can be sorted chronologically. HTTP describes an ETag as an opaque identifier of a representation. Its characters alone therefore imply no general order of changes. Define what an identifier refers to and how it may be compared. Data state, sequence and permitted overwriting need resolving together; a version label alone does not resolve a conflict.

Sources

Articles on this topic

APIs & Integration with ASES

ERP, CRM and shop cleanly connected