The REST API should be aligned with the models defined in the Service Model, not with the Reference Model. RM is to manage data internally, SM is to manage data exchanged.
The issues I’m signalling are
- the partial definition of the SM models,
- the need of harmonization between SM and REST,
- the need to JSON/XML schemas compliant with the SM models,
- a GAP/diff between SM and RM models so implementers understand the differences
All these elements will be applied directly in the conformance spec.