Docs: please provide example of file/image upload (POST) about plone.restapi

[lukasgraf]

I'm working on an update to the docs that explains serialization/deserialzation of non-trivial field types like NamedFile.

For now, this is how you do it:

For a field of type Named[Blob]File (DX) or FileField (AT), serialize the field content as a dictionary with these four keys:

• data - the base64 encoded contents of the file
• encoding - the encoding you used to encode the data, so usually base64
• content-type - the MIME type of the file
• filename - the name of the file, including extension

Example:

POST /plone/folder/
Accept: application/json

      {
        "@type": "File",
        "title": "My file",
        "file": {
            "data": "TG9yZW0gSXBzdW0uCg==",
            "encoding": "base64",
            "filename": "lorem.txt",
            "content-type": "text/plain"}
      }

[mjmare]

Very helpful. Thanks!

[lukasgraf]

Closed via #82

[sarn0ld]

see #662