OAI / OAI/OpenAPI-Specification
More example `same hierarchy` in path templating
Dieses Issue hat noch niemand übernommen.
- Vorherrschende Sprache
- Markdown
- Sterne
- 31.2k
- Forks
- 9.2k
- Ø Merge
- 6 Std. 37 Min.
- Gemergte PRs (30 T.)
- 27
Beschreibung
We can't describe different templated name with same hierarchy.
Templated paths with the same hierarchy but different templated names MUST NOT exist as they are identical.
But I can't understand what the same hierarchy means.
We can't describe these path templates
/pets/{petId}
/pets/{name}
But we can describe these?
/pets/{petId}
/pets/{name}/hello
These depth of the hierarchy is different but these is different templated name in same depth of hierarchy.
When we get /pets/1/hello we can match bottom paths and name=1.
These is partially the same, but the whole is different.
So I want to add more example to this section.
Beitragsleitfaden
Erste Schritte
- Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
- Forke das Repository und arbeite in einem Branch.
- Öffne einen Pull Request, der die Issue-Nummer nennt.
Rechercherichtung
Finde den Abschnitt der Spezifikation, der die zitierte Regel „same hierarchy“ enthält, und lies die umgebenden Hinweise zur Pfad-Templatisierung. Füge ein Beispiel hinzu, das verdeutlicht, warum /pets/{petId} und /pets/{name} kollidieren, während sich der tiefere Pfad /pets/{name}/hello unterscheidet, und prüfe anschließend, ob die Formulierung der Regel entspricht.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Bewertung
- Tech-Stack
- openapi
- Bereich
- documentation
- Issue-Typ
- Dokumentation
- Schwierigkeit
- 2/5
- Geschätzter Aufwand
- 1-3 Stunden
- Aktivitätsstatus
- Veraltet
- Klarheit
- Größtenteils klar
- Anfängerfreundlichkeit
- 55/100