From 052b3a199db8793533a2608c7760ee75d61307ab Mon Sep 17 00:00:00 2001
From: Isaiah Inuwa <iinuwa@moody.edu>
Date: Wed, 19 Feb 2020 13:51:46 -0600
Subject: [PATCH] Add media preview endpoint.

Fixes #39.
---
 src/r0/media/get_media_preview.rs | 34 +++++++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)
 create mode 100644 src/r0/media/get_media_preview.rs

diff --git a/src/r0/media/get_media_preview.rs b/src/r0/media/get_media_preview.rs
new file mode 100644
index 00000000..126b7aba
--- /dev/null
+++ b/src/r0/media/get_media_preview.rs
@@ -0,0 +1,34 @@
+//! [GET /_matrix/media/r0/preview_url](https://matrix.org/docs/spec/client_server/r0.6.0#get-matrix-media-r0-preview-url)
+
+use js_int::UInt;
+use ruma_api::ruma_api;
+use serde_json::Value;
+
+ruma_api! {
+    metadata {
+        description: "Get a preview for a URL.",
+        name: "get_media_preview",
+        method: GET,
+        path: "/_matrix/media/r0/preview_url",
+        rate_limited: true,
+        requires_authentication: true,
+    }
+
+    request {
+        /// URL to get a preview of.
+        #[ruma_api(query)]
+        url: String,
+        /// Preferred point in time (in milliseconds) to return a preview for.
+        #[ruma_api(query)]
+        ts: UInt,
+    }
+
+    response {
+        /// OpenGraph-like data for the URL.
+        ///
+        /// Differences from OpenGraph: the image size in bytes is added to the `matrix:image:size`
+        /// field, and `og:image` returns the MXC URI to the image, if any.
+        #[ruma_api(body)]
+        data: Option<Value>,
+    }
+}