title: REST API for uploading file inside JSON
body: <p>I am designing an REST API to upload a largish (100MB) file together with some information. So it's natural to think of json encoding. </p>
  
  <p>So something like this:</p>
  
  <pre><code>{
     file: content of the file or URL?
     name: string
     description: string
  }
  </code></pre>
  
  <p>The name and description are easy to do with json but I'm not sure how the file content can be added to it.</p>
  
  <p>Also I'm thinking I should use http PUT method. Is this correct?</p>
  
  <p>Incidentally, golang is used to implement this API if it matters.</p>