Search: Add property prefix search OpenAPI definition

Bug: T399270
Change-Id: I05fbc1a8ab3e11d94a38f9d60918c9252594cd41

Author: jakobw

repo/domains/search/specs/global/responses.js

@@ -71,13 +71,13 @@ module.exports = {
 							"id": "P123",
 							"display-label": { "language": "en", "value": "taxon name" },
 							"description": { "language": "en", "value": "scientific name of a taxon" },
-							"match": { "type": "label", "language": "en", "text": "taxon" }
+							"match": { "type": "label", "language": "en", "text": "taxon name" }
 						},
 						{
 							"id": "P234",
 							"display-label": { "language": "en", "value": "taxon rank" },
 							"description": { "language": "en", "value": "level in a taxonomic hierarchy" },
-							"match": { "type": "label", "language": "en", "text": "taxon" }
+							"match": { "type": "label", "language": "en", "text": "taxon rank" }
 						}
 					]
 				}
@@ -108,4 +108,28 @@ module.exports = {
 			}
 		}
 	},
+	"SuggestPropertySuccess": {
+		"description": "A list of search results",
+		"content": {
+			"application/json": {
+				"schema": schemaParts.SearchPropertyResultList,
+				"example": {
+					"results": [
+						{
+							"id": "P123",
+							"display-label": { "language": "en", "value": "taxon name" },
+							"description": { "language": "en", "value": "scientific name of a taxon" },
+							"match": { "type": "label", "language": "en", "text": "taxon name" }
+						},
+						{
+							"id": "P234",
+							"display-label": { "language": "en", "value": "taxon rank" },
+							"description": { "language": "en", "value": "level in a taxonomic hierarchy" },
+							"match": { "type": "label", "language": "en", "text": "taxon rank" }
+						}
+					]
+				}
+			}
+		}
+	},
 };

repo/domains/search/specs/index.fragment.js

@@ -74,6 +74,27 @@ const openapi = {
 					"400": { "$ref": "#/components/responses/BadRequest" }
 				}
 			}
+		},
+		"/v0/suggest/properties": {
+			"get": {
+				"operationId": "simplePropertySuggest",
+				"tags": [ "property search" ],
+				"summary": "[WIP] Simple Property search by prefix, for labels and aliases",
+				"description": "This endpoint is currently in development and is not recommended for production use.",
+				"parameters": [
+					{
+						...parameters.SearchQuery,
+						"example": "taxon"
+					},
+					{ "$ref": "#/components/parameters/SearchLanguage" },
+					{ "$ref": "#/components/parameters/Limit" },
+					{ "$ref": "#/components/parameters/Offset" },
+				],
+				"responses": {
+					"200": { "$ref": "#/components/responses/SuggestPropertySuccess" },
+					"400": { "$ref": "#/components/responses/BadRequest" }
+				}
+			}
 		}
 	},
 	"components": {