Skip to content

Commit 5f765f2

Browse files
committed
Drop uri-reference format for template URLs
`Server.url` and `Link.operationRef` both allow variable substitution with {brackets}, which means they're not always valid URI references. For example, the [current specification][0] shows `https://{username}.gigantic-server.com:{port}/{basePath}` as a Server Object `url`, but it's not a valid URI reference because the host includes curly brackets. [`operationRef`][1] similarly includes `https://na2.gigantic-server.com/#/paths/~12.0~1repositories~1{username}/get` as an example that isn't valid using the `uri-reference` format. I looked into the other uses of `uri-reference` and they seemed ok. Related: - OAI#2586 - OAI#3235 - OAI#3256 - davishmcclurg/json_schemer#158 [0]: https://spec.openapis.org/oas/v3.1.0#server-object-example [1]: https://spec.openapis.org/oas/v3.1.0#operationref-examples
1 parent 6627c32 commit 5f765f2

File tree

2 files changed

+0
-3
lines changed

2 files changed

+0
-3
lines changed

schemas/v3.0/schema.yaml

-1
Original file line numberDiff line numberDiff line change
@@ -975,7 +975,6 @@ definitions:
975975
type: string
976976
operationRef:
977977
type: string
978-
format: uri-reference
979978
parameters:
980979
type: object
981980
additionalProperties: {}

schemas/v3.1/schema.yaml

-2
Original file line numberDiff line numberDiff line change
@@ -119,7 +119,6 @@ $defs:
119119
properties:
120120
url:
121121
type: string
122-
format: uri-reference
123122
description:
124123
type: string
125124
variables:
@@ -632,7 +631,6 @@ $defs:
632631
properties:
633632
operationRef:
634633
type: string
635-
format: uri-reference
636634
operationId:
637635
type: string
638636
parameters:

0 commit comments

Comments
 (0)