How to change query parameter name in swagger?

Multi tool use
Multi tool use


How to change query parameter name in swagger?



I am trying to get this url:



https://search.me/Search/api/search?map=%7B%22query%22:%22CSCI+250%22,%22rows%22:500,%22term%22:%222181%22,%22career%22:%22%22,%7D


https://search.me/Search/api/search?map=%7B%22query%22:%22CSCI+250%22,%22rows%22:500,%22term%22:%222181%22,%22career%22:%22%22,%7D



without converting special characters to HEX to URL would be:



https://search.me/Search/api/search?map={query:CSCI-250,rows:500,term:2181,career:}


https://search.me/Search/api/search?map={query:CSCI-250,rows:500,term:2181,career:}



I know it is not possible to serialize special characters as hex in openapi 3.0.0, so I am fine with the full JSON in the query parameter.



Where the parameter is a JSON -> URI
The JSON is:


{
map: {
"query": "CSCI 250",
"rows": 500,
"term": 2181,
"career": ""
}
}



but swagger instead renders:



https://search.me/search/api/search?query=CSCI-250&rows=500&term=2181&career=


https://search.me/search/api/search?query=CSCI-250&rows=500&term=2181&career=



As you can see, special characters are then converted into HEX.



Below is my path. What exactly am I doing wrong?


paths:
/search:
get:
summary: Search
parameters:
- in: query
name: map
description: JSON for lookup
required: true
schema:
$ref: '#/components/schemas/QueryParams'
responses:
200:
description: Course search response
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/QueryResults'
400:
description: Bad request





Is the expected example .../map?=CSCI-250 correct? It has = directly after ? so the first parameter name seems to be missing.
– Helen
Jul 2 at 14:01


.../map?=CSCI-250


=


?





I added the correct URL that I need. @Helen
– Pants
Jul 2 at 14:17





I don't mind not converting to hex as I documented this, I just want the correct parameter name to be displayed. Should be map not query
– Pants
Jul 2 at 14:20


map


query





Possible duplicate of Defining an API with swagger: GET call that uses JSON in parameters
– Helen
Jul 2 at 14:40





My answer there is for OpenAPI 3.0.
– Helen
Jul 2 at 14:59









By clicking "Post Your Answer", you acknowledge that you have read our updated terms of service, privacy policy and cookie policy, and that your continued use of the website is subject to these policies.

6LJFw,o550YePKJeok
-
wH7 bk0dDy8LIqNZTp7x5ALh 6,TLKHgS 1L0Tyqb5QjySSiF nfhuzoqraAV HGtB6hx,l48063i

Popular posts from this blog

PHP contact form sending but not receiving emails

PHP contact form sending but not receiving emails I have created a contact form using PHP to send the data. The form seems to send fine as there are no errors and success message appears, however I am not receving the emails into the designated inbox. I am using PHPMailer as I originally tried just using the php 'mail' command which I now understand is a bit hit and miss. I cannot see why I would not be receving the emails so I would be very grateful for any help that could be given. I'm quite new to PHP so please be patient with me :) <?php use PHPMailerPHPMailerPHPMailer; use PHPMailerPHPMailerException; $msg = ""; if (isset($_POST['submit'])) { require 'phpmailer/src/Exception.php'; require 'phpmailer/src/PHPMailer.php'; require 'phpmailer/src/SMTP.php'; function sendemail ($to, $from, $body) { $mail = new PHPMailer(true); $mail->setFrom($from); $mail->addAddress($to); $ma...
Read more

Do graphics cards have individual ID by which single devices can be distinguished?

Do graphics cards have individual ID by which single devices can be distinguished? I have several graphics cards of the same manufacturer and same model and I want to distinguish them not only by the pcie socket they reside in but by some individual value I can read from the hardware. Is there such value and if so what would it be called and how could I access it? Right now I'm using modern nvidia cards (10xx series) and nvidia inspector.but I'd prefer if there was any value that was also applicable to amd. I have programming and scripting knowledge. I am running Windows 10 1 Answer 1 This is a powershell example to pull information from video cards. The DeviceID is supposed to be unique but only if the manufacturer supports Windows Display Driver Model (WDDM). (I copied this directly from docs.microsoft.com) $strComputer = "." $colItems = get-wmiobject -class "Win32_VideoC...
Read more

Create weekly swift ios local notifications

Create weekly swift ios local notifications I can create daily notifications but not weekly ones using swift 3 ios 10 User Notifications framework. Daily works fine but when I add in the .weekday parameter it doesn't send me a notification. The code is: for i in 1 ... 7 { let center = UNUserNotificationCenter.current(); let content = UNMutableNotificationContent(); content.title = "Title"; content.body = "content"; content.sound = UNNotificationSound.default(); var dateComponents = DateComponents(); dateComponents.weekday = i; // hours is 00 to 11 in string format if (daynight == "am") { dateComponents.hour = Int(hours); } else { dateComponents.hour = Int(hours)! + 12; } // mins is 00 to 59 in string format dateCom...
Read more