OAI / OAI/OpenAPI-Specification

Add default responses

Ouverte
#563 27 commentaires 60 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

re-use: globals/defaults
Langage dominant
Markdown
Étoiles
31.2k
Forks
9.2k
Merge moyen
6 h 37 min
PR mergées (30 j)
27

Description

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.

Guide de contribution

Ouvrir le guide de contribution

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Piste de recherche

Commencez par examiner la discussion de l’issue et le构ent de niveau supérieur security existant dans la spécification OpenAPI. Définissez le fonctionnement d’une section responses de niveau supérieur et la manière dont les opérations la remplacent ; le travail est considéré comme terminé lorsque la spécification documente clairement à la fois les réponses par défaut et le comportement de remplacement.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Stack technique
openapi
Domaine
api
Type d'issue
Fonctionnalité
Difficulté
5/5
Temps estimé
Plus d'une semaine
Activité
Calme
Clarté
Plutôt claire
Accessibilité débutants
35/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.