FEAT: Swicthed QUERY Method To GET

discovery/internal/api/videos.go

@@ -12,26 +12,10 @@ type Video struct {
 	Categories  []string `json:"categories" example:"documentary,news"`
 }
 
-// SearchRequest is the body of QUERY /api/videos: what a reader is looking
-// for. Every member is optional — an empty body browses the whole catalogue.
-type SearchRequest struct {
-	// Title is matched lexically against video titles: the words are all
-	// required, and the last is treated as a prefix so a part-typed word still
-	// finds something.
-	Title string `json:"title" example:"desert fal"`
-	// Categories narrows the search to videos filed under any one of these
-	// names — not all of them, so it widens the choice of category while
-	// narrowing the results. Empty means every category.
-	Categories []string `json:"categories" example:"documentary,news"`
-	// Limit is how many videos to return. Absent or zero takes the default of
-	// 20; anything above the maximum of 100 is capped to it rather than
-	// refused, and the cursor still reaches the rest.
-	Limit int `json:"limit" example:"20"`
-	// Cursor asks for the page after the one a previous search ended at. Send
-	// back the nextCursor from that search, unchanged; it is opaque, and the
-	// only thing to do with it is return it.
-	Cursor string `json:"cursor"`
-}
+// The search itself takes no body type: GET /api/videos reads its parameters
+// — title, categories, limit and cursor — from the query string, so there is
+// no request document to publish a schema for. They are documented as
+// parameters on handlers.SearchVideos, and appear in the generated spec there.
 
 // SearchResults is one page of search results.
 type SearchResults struct {