From 05c25b8b96b2250aafff1a1344694471ed343116 Mon Sep 17 00:00:00 2001
From: Alex Thomassen <alex@thomassen.xyz>
Date: Tue, 11 Oct 2022 19:24:26 +0200
Subject: [PATCH] [YouTube] Document caching on `videoid`

---
 public/static/yaml/endpoints/youtube.yaml |  1 +
 src/components/Cached.vue                 | 18 ++++++++++++++++++
 2 files changed, 19 insertions(+)

diff --git a/public/static/yaml/endpoints/youtube.yaml b/public/static/yaml/endpoints/youtube.yaml
index dce83b2..1ae8938 100644
--- a/public/static/yaml/endpoints/youtube.yaml
+++ b/public/static/yaml/endpoints/youtube.yaml
@@ -34,3 +34,4 @@ endpoints:
       notes:
         - 'Searches the YouTube API with the specified string and returns the first result it can find (if any).'
         - 'If the search string is a valid video ID, it will just return the video ID.'
+        - 'Searches are cached for up to 3 hours, to avoid repeated YouTube API requests. This only applies to exact & case insensitive matches on search queries.'
diff --git a/src/components/Cached.vue b/src/components/Cached.vue
index d52e9c1..865f4af 100644
--- a/src/components/Cached.vue
+++ b/src/components/Cached.vue
@@ -83,6 +83,24 @@
                 </tr>
             </tbody>
         </table>
+
+        <h3><i class="fab fa-youtube"></i> YouTube</h3>
+        <table class="table table-bordered">
+            <thead>
+                <th><i class="fas fa-link fa-fw fa-1x"></i> API Endpoint</th>
+                <th><i class="fas fa-clock fa-fw fa-1x"></i> Cache length</th>
+                <th><i class="fas fa-sticky-note fa-fw fa-1x"></i> Description</th>
+            </thead>
+            <tbody>
+                <tr>
+                    <td><code>videoid</code></td>
+                    <td>3 hours (10800 seconds)</td>
+                    <td>
+                        Searches are cached for up to 3 hours. Only affects exact searches (case insensitive, e.g. <code>Never Gonna Give You Up</code> = <code>never gonna give you up</code>).
+                    </td>
+                </tr>
+            </tbody>
+        </table>
     </div>
 </template>