Response from Media Endpoint #13

Activity

1. j4y-funabashi commented on Apr 23, 2019

   

   j4y-funabashi

   on Apr 23, 2019

   More actions

   Currently my media endpoint returns the following when I call it with q=source

   {
       "items": [
           {
               "url": "https://media.funabashi.co.uk/2019/vid.mp4",
               "mime_type": "video/mp4",
               "date_time": "2019-03-20T16:53:29.762421201Z",
               "lat": 53.800968166666664,
               "lng": -1.5413559444444442
           }
       ]
   }
   
2. dshanske

   added

   media endpointMedia EndpointMedia Endpoint

   on Jun 28, 2020
3. manton commented on Jul 15, 2020

   

   manton

   on Jul 15, 2020

   More actions

   I don't currently support this, but I just want to point to #14 here since the response should be the same for both. There was a discussion there about using published for the date so that it's consistent with other parts of Micropub. Here's what my response from the media endpoint with q=source looks like:

   {
     "items": [
       {
         "url": "https://www.manton.org/uploads/2020/058fa92305.png", 
         "width": 1200, 
         "height": 816,
         "published": "2020-05-27T14:14:09+00:00"
       }, 
       {
         "url": "https://www.manton.org/uploads/2020/7a57980ca2.jpg", 
         "width": 1800, 
         "height": 1800,
         "published": "2020-05-20T02:22:09+00:00"
       }
     ]
   }
   
4. dshanske commented on Jul 25, 2020

   

   dshanske

   on Jul 25, 2020

   MemberAuthor

   More actions

   In order to address this, the initial agreement at the Micropub Popup 2020 was to require on upload a response that included a url property only. Any other properties are still pending for discussion, but suggested that it be considered based on prior art of EXIF properties.
5. aaronpk commented on Jul 25, 2020

   

   aaronpk

   on Jul 25, 2020

   Member

   More actions

   Copying notes from the wiki:

   ---

   Content-Type: application/json
   
   {
     "url": "https://media.aaronpk.com/filename.jpg"
   }

   This response currently produced by:

   • aaronpk in his media endpoint on media.aaronpk.com
   • myfreeweb in [https://indieweb.org/sweetroll sweetroll] — instead of "url" there's a JSON structure with a bunch of stuff. For photos: "width", "height", "meta" (metadata extracted by exiv2), "palette" (prominent colors via vibrant), "tiny_preview" (data uri of a tiny WebP preview) and most importantly "source" (links to the actual image in different formats).
   • WordPress Micropub currently returns the parsed metadata about the media file and the alternate sizes currently generated by WordPress on a file upload. It is not specifically reformatted for Micropub at this time.
   • cleverdevil added support for this response in Known in November 2018.

   And consumed by:

   • aaronpk - a iOS Workflow that I created to upload to my media endpoint requests a text/plain response and uses the body as the URL, copying it to the clipboard. that was easier than adding a JSON parser to the Workflow.
   • myfreeweb - sweetroll does rich photo display based on the data generated by the endpoint.
6. dshanske commented on Jul 26, 2020

   

   dshanske

   on Jul 26, 2020

   MemberAuthor

   More actions

   Looking at Exif 2.32 http://www.cipa.jp/std/documents/download_e.html?DC-X010-2020, which is the latest version and makes some changes.

   EXIF has 3 time properties

   • DateTime - the last modified time
   • DateTimeOriginal - when the original was generated
   • DateTimeDigitized - when the original was digitized

   Suggesting that updated might take the place of datetime.

   Other potentially useful properties to start

   • Description
   • Artist
   • Copyright
   • Latitude/Longitude/Altitude
   • Width and Length(EXIF uses length as opposed to width and height)

   There are other properties, such as lens, camera make/model, ISO, aperture...

   And this only covers photos...
7. manton commented on Jul 27, 2020

   

   manton

   on Jul 27, 2020

   More actions

   Micro.blog now returns url in JSON from the media endpoint when uploading. The url matches the value in the Location header. If you're uploading video, Micro.blog also generates a poster frame and returns that too:

   {
     "url": "https://manton.org/uploads/2020/example.mov",
     "poster": "https://manton.org/uploads/2020/example.png"
   }
   
8. manton commented on Nov 30, 2021

   

   manton

   on Nov 30, 2021

   More actions

   Bumping this since @dshanske mentioned it in chat… I'd be in favor of adding image width and height as simple fields in the JSON response, but I don't think we need to include every possible bit of metadata there.
9. dshanske commented on Dec 1, 2021

   

   dshanske

   on Dec 1, 2021

   MemberAuthor

   More actions

   Agree about every piece of metadata. I'd like width, height, and dates...and to address the question of multiple sizes the server might generate. Many services have the concept of a thumbnail version in their returns, but it isn't consistent. @manton commented in chat that Micro.blog returns a 400w thumbnail for images. Because of different sizes/shapes of images, there is no good answer.