--- name: they-said-so-quotes-api description: "They Said So Quotes API skill. Use when working with They Said So Quotes for qod, quote, qshow. Covers 45 endpoints." version: 1.0.0 generator: lapsh --- # They Said So Quotes API API version: 5.1 ## Auth Bearer bearer ## Base URL https://quotes.rest ## Setup 1. Set Authorization header with Bearer token 2. GET /qod -- gets `quote of the day` (qod). optional `category` param determines the category of returned quote of the day 3. POST /quote -- create first quote ## Endpoints 45 endpoints across 3 groups. See references/api-spec.lap for full details. ### Qod | Method | Path | Description | |--------|------|-------------| | GET | /qod | Gets `Quote of the Day` (QOD). Optional `category` param determines the category of returned quote of the day | | PUT | /qod | Create a private `Quote of the Day` service. | | PATCH | /qod | Update an existing private `Quote of the Day` definition. | | GET | /qod/categories | Gets a list of `Quote of the Day` Categories. | | GET | /qod/languages | Gets a list of supported languages for `Quote of the Day`. | ### Quote | Method | Path | Description | |--------|------|-------------| | GET | /quote/random | Gets a `Random Quote`. When you are in a hurry this is what you call to get a random famous quote. | | GET | /quote/search | Search for a `Quote` in They Said So platform. Optional `category` , `author`, `minlength`, `maxlength` params determines the filters applied while searching for the quote. | | GET | /quote/categories/popular | Gets a list of popular `Quote` Categories. | | GET | /quote/categories/search | Gets a list of `Quote` Categories matching the query string. | | GET | /quote/authors/popular | Gets a list of popular author names in the system. | | GET | /quote/authors/search | Gets a list of author names in the system. | | PUT | /quote | Add a new quote to your private collection. | | POST | /quote | Add a new quote to your private collection. Same as 'PUT' but added since some clients don't handle PUT well. | | PATCH | /quote | Update a quote | | GET | /quote | Gets a `Quote` with a given `id`. | | DELETE | /quote | Delete a quote. The user needs to be the owner of the quote to be able to delete it. | | GET | /quote/list | Get the list of quotes in your private collection. | | POST | /quote/tags/add | Add a tag to a given Quote. | | POST | /quote/tags/remove | Remove a tag from a given quote. | | GET | /quote/like/toggle | Toggle the user like of the given Quote as a user of the API Key. | | GET | /quote/bookmark/toggle | Toggle the user bookmark of the given Quote as a user of the API Key. | | PUT | /quote/image | Create a new quote image for a given quote. Choose background colors/images , choose different font styles and generate a beautiful quote image. Did you just had a feeling of being a god or what?! | | GET | /quote/image | Gets a Quote image for a given id. Response can be an image file as a binary or a base64 encoded contents wrapped in json. `TODO` | | DELETE | /quote/image | Delete a quote image. The user needs to be the owner of the quote image to be able to delete it. | | GET | /quote/image/search | Gets a Random Quote image. Optional `category` param determines the category of quote used in the image. Optional `author` param gets the quote image of a given author. | | POST | /quote/image/background | Add an image for use later as a quote background image. | | DELETE | /quote/image/background | Delete a background image file. The user needs to be the owner of the background image to be able to delete it. | | GET | /quote/image/background/search | Searches for a background image with a given tag. | | GET | /quote/image/background/list | Lists background images in your private collection. | | POST | /quote/image/background/tags/add | Add a tag to a given Image. | | POST | /quote/image/background/tags/remove | Remove a tag from a given Image. | | POST | /quote/image/font | Add a font file for use later in creating a quote image. This is essentially a `PUT` but not many clients handle PUT with binary stream i.e. a file, gracefully. | | DELETE | /quote/image/font | Delete a font file. The user needs to be the owner of the font to be able to delete it. | | GET | /quote/image/font/search | Searches for a font with a given tag. | | GET | /quote/image/font/list | Lists background images in your private collection. | | POST | /quote/image/font/tags/add | Add a tag to a given font. | | POST | /quote/image/font/tags/remove | Remove a tag from a given Font. | ### Qshow | Method | Path | Description | |--------|------|-------------| | PUT | /qshow | Create and add a new qshow to your private collection. | | GET | /qshow | Gets a details about a qshow. | | PATCH | /qshow | Update an existing qshow. | | DELETE | /qshow | Delete a qshow. | | POST | /qshow/quotes/add | Add a quote to a given Qshow. | | POST | /qshow/quotes/remove | Remove a quote to a given Qshow. | | GET | /qshow/quotes | Get the quotes in a given Qshow. | | GET | /qshow/list | Get the list of Qshows in They Said So platform. | ## Common Questions Match user requests to endpoints in references/api-spec.lap. Key patterns: - "List all qod?" -> GET /qod - "List all categories?" -> GET /qod/categories - "List all languages?" -> GET /qod/languages - "List all random?" -> GET /quote/random - "Search search?" -> GET /quote/search - "List all popular?" -> GET /quote/categories/popular - "Create a quote?" -> POST /quote - "List all quote?" -> GET /quote - "List all list?" -> GET /quote/list - "Create a add?" -> POST /quote/tags/add - "Create a remove?" -> POST /quote/tags/remove - "List all toggle?" -> GET /quote/like/toggle - "List all qshow?" -> GET /qshow - "List all quotes?" -> GET /qshow/quotes - "List all image?" -> GET /quote/image - "List all search?" -> GET /quote/image/search - "Create a background?" -> POST /quote/image/background - "Create a font?" -> POST /quote/image/font - "How to authenticate?" -> See Auth section above ## Response Tips - Check response schemas in references/api-spec.lap for field details - Paginated endpoints accept limit/offset or cursor parameters - Create/update endpoints return the modified resource on success - Error responses include status codes and descriptions in the spec ## References - Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas > Generated from the official API spec by [LAP](https://lap.sh)