OAI / OAI/OpenAPI-Specification
Clarification on the purpose of the API license?
@lornajane arbeitet bereits daran.
Seit 02.7.2026.
- Vorherrschende Sprache
- Markdown
- Sterne
- 31.2k
- Forks
- 9.2k
- Ø Merge
- 6 Std. 37 Min.
- Gemergte PRs (30 T.)
- 27
Beschreibung
In the Swagger 2.0 specification, there is support for adding a License as one of the informational fields and the description for this is License information for the exposed API.
This seems a bit ambiguous, since a license could potentially be understood to apply to one or more of the following contexts:
- Use of the API. This situation seems to be already handled by the
termsOfServicesection though. - Data retrieved from the API
- The specification JSON/YAML for the API indeed, there is a license for the Swagger 2 specification
- Client/server code generated via swagger-codegen could some licenses theoretically extend to that?
I am guessing that the item 3 is the intended use for the license field, but I will admit that at first I thought it was meant for the first case and I could not see how a license would actually apply. Is it possible to get some clarification of how licenses should be picked here and where they do and do not apply?
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.
Bewertung
Dieses Issue wurde noch nicht bewertet.