blurhash in "info", download->blurhash

proposals/2448-blurhash-for-media.md

@@ -13,6 +13,9 @@ receipt other clients can render for a pretty preview while the actual
 thumbnail downloads. They also do not contain any `"` characters, making them
 simple to stick inside existing JSON blobs.
 
+To be clear: A BlurHash does not replace a thumbnail - it will be shown
+before the thumbnail is downloaded.
+
 ## Proposal
 
 ### m.room.message
@@ -41,11 +44,11 @@ Example `m.room.message` content field:
     },
     "w": 301,
     "h": 193,
-    "thumbnail_url": "mxc://example.org/abcdefg"
+    "thumbnail_url": "mxc://example.org/abcdefg",
+    "blurhash": "JadR*.7kCMdnj"
   },
   "msgtype": "m.image",
   "url": "mxc://example.org/abcde",
-  "blurhash": "JadR*.7kCMdnj"
 }
 ```
 
@@ -62,7 +65,7 @@ An optional attribute is added to `<img>` tags in messages:
 `data-mx-blurhash`, where the value of the attribute is the blurhash
 representation of the inline image.
 
-This would be optionally displayed with the inline image itself is loaded in
+This would be optionally displayed while the inline image itself is loaded in
 parallel.
 
 Example `m.room.message.formatted_body`:
@@ -71,9 +74,6 @@ Example `m.room.message.formatted_body`:
 "formatted_body": This is awesome <img alt=\"flutterjoy\" title=\"flutterjoy\" height=\"32\" src=\"mxc://matrix.example.org/abc\" data-blurhash=\"LEHV6nWB2yk8pyo\" />
 ```
 
-To be clear: This does not replace thumbnails - it will be shown before they
-are downloaded.
-
 ## Calculating a blurhash
 
 BlurHashes are inserted into `m.room.message` events by the client, however
@@ -99,12 +99,12 @@ Example response:
 In addition, a new endpoint will be added to the Media API that allows a
 client with an existing mxc URL to retrieve a blurhash for it from the
 server. It will take the form of `GET
-/_matrix/media/r0/download/{serverName}/{mediaId}/blurhash`.
+/_matrix/media/r0/blurhash/{serverName}/{mediaId}`.
 
 Example request:
 
 ```
-GET /_matrix/media/r0/download/example.com/abcde12345/blurhash
+GET /_matrix/media/r0/blurhash/example.com/abcde12345
 ```
 
 Example response: