OAI / OAI/OpenAPI-Specification

Add default responses

Abierto
#563 27 comentarios 60 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

re-use: globals/defaults
Lenguaje dominante
Markdown
Estrellas
31.2k
Forks
9.2k
Merge medio
6 h 37 min
PR fusionados (30 d)
27

Descripción

Currently, every single operation must declare its' own responses. This causes a whole bunch of duplication, which would be better served by having a top-level responses section in the spec. Like the security construct, operations could override the default responses on their own.

Guía de contribución

Abrir la guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Línea de trabajo

Comienza revisando la discusión del issue y la construcción de nivel superior security existente en la especificación de OpenAPI. Define cómo funcionaría una sección responses de nivel superior y cómo las operaciones la sobrescribirían; se considerará terminado cuando la especificación documente claramente tanto las respuestas predeterminadas como el comportamiento de sobrescritura.

Escrito por el modelo de indexación a partir del texto del issue.

Evaluación

Stack tecnológico
openapi
Área
api
Tipo de issue
Nueva funcionalidad
Dificultad
5/5
Tiempo estimado
Más de una semana
Estado de actividad
Tranquilo
Claridad
Bastante claro
Aptitud para principiantes
35/100

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.