Hacktoberfest 2026 : les issues que les mainteneurs ont marquées pour octobre, ouvertes et accessibles aux débutants. Parcourir les issues Hacktoberfest

Consolidated $ref-to-Some Object feature request

Ouverte
#3,853 8 commentaires 7 réactions 0 personnes assignées Voir sur GitHub

Les mainteneurs répondent en général sous 1 jour

Personne n'a encore pris cette issue.

Évaluation

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

Piste de recherche

Commencez par examiner les issues liées concernant Security Requirement, Security Scheme, Server, Tags, Operation, Media Type, Contact et License afin de comprendre les cas d’utilisation et les alternatives distincts. Définissez les modifications nécessaires de la spécification pour prendre en charge $ref pour ces objets, y compris les impacts signalés sur operationId ; le travail est terminé lorsque les cas concernés sont résolus de manière cohérente dans l’OpenAPI Specification.

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

Description

re-use: ref-everywhere

This issure consolidates and replaces the numerous "can the OAS allow $ref for..." issues:

  • Security Requirement: OAI/OpenAPI-Specification#1850
  • Security Scheme: OAI/OpenAPI-Specification#1972 (but see also OAI/OpenAPI-Specification#3776 for an alternative)
  • Server: OAI/OpenAPI-Specification#2338
  • Tags: OAI/OpenAPI-Specification#2905
  • Operation: OAI/OpenAPI-Specification#2922 (but note that there are impacts on finding and resolving operationId)
  • Media Type: OAI/OpenAPI-Specification#3056 (closed because the specific use case is handled by overriding description with a Reference Object); also OAI/OpenAPI-Specification#2845 although there is more to that one)
  • Contact: OAI/OpenAPI-Specification#3552
  • License: OAI/OpenAPI-Specification#3569
Langage dominant
Markdown
Étoiles
31.3k
Forks
9.2k
Merge moyen
2 j 3 h
PR mergées (30 j)
8

Préparer son environnement

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.

Autres issues de OAI/OpenAPI-Specification

Toutes les issues de OAI/OpenAPI-Specification

Issues similaires

Plus d'issues Backend & API Design

Recevez les nouvelles issues par e-mail

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