How to define both fixed and dynamic fields in request body (visible in Swagger/Mintlify UI)?
I'm working on an OpenAPI 3.0 specification and I need to define a request body schema that includes: Two static fields: title (string) and description (string), both required Additional dynamic/custom fields with unknown names and values that can be complex (objects, arrays, strings, etc.) I have tried using additionalProperties like this: { "type": "object", "properties": { "title": { "type": "string" }, "description": { "type": "string" } }, "required": ["title", "description"], "additionalProperties": true }
Info object is ignored in swagger ui
When I view the REST api of my spring boot application in swagger-ui, the info object (title, version and description) of my yaml definition is ignored and only default values ("OpenAPI definition", "v0", no description) are shown. Why could that be? yaml: swagger-ui:
How to add AWS authentication to my OPEN API SPEC
I am documenting an existing API with OpenAPI. The API uses AWS authentication. I have been testing the API using postman, where I add Aws access key and Signature in the Auth section of Postman. But on close inspection, it turns out that Postman does some HMAC manipulation on the secret key and then sends it in header. I am not sure how to document this Auth process in the OpenAPI spec? I would prefer the user to be only aware of AWS Access key and secret and not the manipulations/conversions that need to be performed. Is there a way I can document this authentication procedure with OpenAPI?Regarding Invalid Client on jackhenry DMZ loan Vantage Postman Collection to get access token
I am getting error invalid client as you can see in the attached screenshot, despite after entering the Client_id and Client_secret I should be able to get the access token but getting again and again :- { "error": "invalid client" } does anybody have an idea of this error, because without the access token I won't be able to proceed further so if anyone has any idea or has consumed this, suggest me it would be very helpful For more information I am attaching the Url:- https://jackhenry.dev/jxchange-rest/providers/loanvantage/api-reference/#/Document/DocumentCreate Also I am attaching the screenshot of the documentation of LoanVantage DMZ that I have imported in postman as per the guidelines in the documentation.
Can Swagger UI for Openapi v3 handle arrays in multipart requests?
I have the following Openapi document: { "info": { "description": "This document shows strange behavior in swagger ui", "title": "This document shows a strange behavior in swagger ui", "version": "0.0.0" }, "openapi": "3.0.0", "paths": { "/post": { "post": { "description": "Upload multiple files", "requestBody": { "content": { "multipart/form-data": { "schema": { "properties": { "inputResources": { "items": { "type": "string" }, "type": "array" } }, "type": "object" } } }, "description": "Multipart body to upload files" } } }, }, "servers": [ { "url": "https://httpbin.org" } ] } I want to display it with Swagger UI so I created the following HTML page: <script src="https://unpkg.com/swagger-ui-dist@3/swagger-ui-bundle.js"></script> <script src="https://unpkg.com/swagger-ui-dist@3/swagger-ui-standalone-preset.js"> </script> <script> window.onload = function() { const ui = SwaggerUIBundle({ url: "path/to/above/document", validatorUrl : null, dom_id: '#swagger-ui', deepLinking: true, }) window.ui = ui } </script> <div id="swagger-ui"></div> I get a nice display of my request However when I execute it the following multipart body is sent: ------WebKitFormBoundaryzRaOvYA1aX8T4BXu Content-Disposition: form-data; name="inputResources" ewrr,eeee ------WebKitFormBoundaryzRaOvYA1aX8T4BXu-- As you see the strings are just comma-separated which is not a valid way to encode an array of strings in a multipart body. I would expect a part for each string element to be created like that: ------WebKitFormBoundaryzRaOvYA1aX8T4BXu Content-Disposition: form-data; name="inputResources" ewrr ------WebKitFormBoundaryzRaOvYA1aX8T4BXu Content-Disposition: form-data; name="inputResources" eeee ------WebKitFormBoundaryzRaOvYA1aX8T4BXu-- Even worse when I change the format of the inputResources property to binary to send files instead. "inputResources": { "items": { "format": "binary", "type": "string" }, "type": "array" } This changes the multipart body to the following: ------WebKitFormBoundary5OvyKi6BDAuPKnFm Content-Disposition: form-data; name="inputResources" [object File],[object File] ------WebKitFormBoundary5OvyKi6BDAuPKnFm-- Again I would have expected two parts with the respective file's binary content. Am I assuming correctly that Swagger UI simply does not support arrays yet in multipart request bodies? Or did I do something wrong? Kind regards, NeidhartManaging Multiple Auth Methods in Swagger UI
Hello everyone, I'm currently working on a Laravel project and facing a challenge with defining multiple authentication types in L5-Swagger. My app uses both HTTP Bearer Token (token) and Laravel Passport (passport). I want passport to act as a fallback only when the token isn't defined. (Purpose of the fallback authentication is protecting our endpoints from unwanted calls with predefined credencials.) I want to instruct Swagger UI to correctly select the preferred token in the request headers. This would ensure that users testing the API through Swagger UI use the appropriate authentication scheme (token) by default unless it’s unavailable, in which case passport should be used. Based on OpenAPI logic, security schemes can be combined using logical OR and AND. Here are my desired rules: Primary: Prefer token for authentication. Fallback: Use passport only if token isn't defined. User-Specific Endpoints: Certain endpoints strictly require the token and, due to mutual exclusivity, will not allow passport. Flexible Endpoints: Other endpoints can accept either token or passport. According to OpenAPI docs, I can structure the security configuration as follows: 'security' => [ [ 'token' => [], ], [ 'passport' => [], ], ], My Questions: Is this the correct way to prioritize token over passport in L5-Swagger? Are there better practices to structure authentication hierarchies in Swagger docs for Laravel applications? Any help or suggestions would be greatly appreciated! Thanks in advance! :) Star
Swagger UI rendering issues
Hi Our team faced following issue https://github.com/springdoc/springdoc-openapi/discussions/2868 after updating to the latest version. For now we are using workaround provided in answers of this thread and related issue. But, it would be nice to have Swagger UI rendering correction for OpenAPI 3.1. Thank you
