rest.li icon indicating copy to clipboard operation
rest.li copied to clipboard

What is PSON?

Open berezovskyi opened this issue 1 year ago • 0 comments

https://linkedin.github.io/rest.li/user_guide/restli_client says it's a format with a MIME type of application/x-pson, https://linkedin.github.io/rest.li/spec/protocol refers to the MIME type application/pson. The best guess I have is that it refers to the PSON spec draft from 2013 (but its Section 6 suggests a plain application/octet-stream MIME type). There is another (?) PSON from Puppet with the MIME types of text/pson and, even more bewildering, just pson. There is also an academic publication that introduces PSON, apparently used by an IoT platform "Thinger.io".

Could you please:

  1. Update the docs to clarify what exactly PSON refers to and if it's distinct from the aforementioned PSON specs, what spec does Rest.li's PSON follow?
  2. Consider changing the name from PSON to something else (or coordinate with Puppet to disambiguate) if it's an enconding distinct from the existing two (three?)? Thinger seems to have renamed their serialization to Protoson https://github.com/thinger-io/Protoson .

berezovskyi avatar May 11 '23 17:05 berezovskyi