Normalize Lark JSON format for Concepts
Lark currently accepts and returns a JSON format, but the structure/schema of the format is so far undocumented and not reliable.
This ticket is to normalize and document the JSON we accept and output. Note that this should be a minimal first pass; we still need stakeholder feedback on the format, and JSON may not be a very format for the API in the long run. Instead of polishing, we just want to have a viable format for feedback.
Acceptance Criteria:
-
A full record create/update cycle should work from start to finish. -
After retrieving an existing record with GET
, an update with PUT using modified JSON from the response body should work.
-
-
There is documentation linked from https://gitlab.com/surfliner/surfliner/blob/master/lark/README.md#supported-media-types that described the supported format
See: RecordParser
and RecordSerializer
Edited by tamsin woo