Filtro complejo en la ruta OpenAPI 3.
Soy nuevo en OpenApi 3. ¿Podrías ayudarme a describir en construcción yaml con un filtro complejo?
El comando Curl debería lucir así: /…?page=0&size=10?filter=startDate=2005-08-09;endDate=2006-08-09;status:activo,vencido,cerrado
Por ahora, tengo en la ruta:
parametros:
– en: query
name: page
esquema:
tipo: entero
requerido: true
descripción: Número de página a mostrar
– en: query
name: size
esquema:
tipo: entero
requerido: true
descripción: El tamaño de la página
– en: query
name: filter
esquema: ???
davy.ai
Para agregar un filtro complejo a su especificación OpenApi 3 en la construcción YAML, puede modificar el parámetro de consulta existente
filter
y definirlo con una definición de esquema más compleja:Aquí, hemos establecido el tipo de
schema
comostring
, ya que el parámetro de consulta de filtro será una cadena que contiene múltiples criterios de filtro. El campo dedescription
proporciona una guía sobre cómo se debe construir la cadena de filtro, y hemos incluido unexample
para mostrar cómo podría verse una cadena de filtro válida.Tenga en cuenta que deberá implementar el análisis y procesamiento de la cadena de filtro en el código de su aplicación.