with the same version.

-- .mod --
module example.net/ambiguous/nested

go 1.16
-- .info --
{"Version": "v0.1.0"}
-- go.mod --
module example.net/ambiguous/nested

go 1.16
-- pkg/pkg.go --
// Package pkg exists in both example.net/ambiguous v0.1.0
// and example.net/ambiguous/nested v0.1.0

example.com/invalidpath/v1 v1.0.0
written by hand

-- .mod --
module example.com/invalidpath/v1
-- .info --
{"Version":"v1.0.0"}
-- go.mod --
module example.com/invalidpath/v1
-- version.go --
package version

* `Query()`
* `Header()`
* `Cookie()`
* `Body()`
* `Form()`
* `File()`

você também pode declarar um dado `example` ou um grupo de `examples` com informações adicionais que serão adicionadas ao **OpenAPI**.

### `Body` com `example`

Aqui nós passamos um `example` dos dados esperados por `Body()`:

```Python hl_lines="21-26"
{!../../../docs_src/schema_extra_example/tutorial003.py!}
```

### Exemplo na UI da documentação

example.com/badchain/a v1.0.0

-- .mod --
module example.com/badchain/a

require example.com/badchain/b v1.0.0
-- .info --
{"Version":"v1.0.0"}
-- a.go --
package a

The v1.0.0 release of example.com/retract/incompatible retracts
v2.0.0+incompatible.

-- .mod --
module example.com/retract/incompatible

go 1.16

retract v2.0.0+incompatible
-- .info --
{"Version":"v1.0.0"}
-- go.mod --
module example.com/retract/incompatible

go 1.16

retract v2.0.0+incompatible
-- incompatible.go --

example.com/cmd contains main packages.

-- .info --
{"Version":"v1.9.0"}
-- .mod --
module example.com/cmd

go 1.16

// this is a bad version
retract v1.9.0
-- go.mod --
module example.com/cmd

go 1.16

// this is a bad version
retract v1.9.0
-- a/a.go --
package main

func main() {}
-- b/b.go --
package main

func main() {}
-- err/err.go --
package err

example.com/downgrade/v2 v2.0.1
written by hand

-- .mod --
module example.com/downgrade/v2

require rsc.io/quote v1.5.2
-- .info --
{"Version":"v2.0.1"}
-- go.mod --
module example.com/downgrade/v2

example.com/latemigrate/v2 v2.0.0
written by hand

This repository migrated to modules in v2.0.1 after v2.0.0 was already tagged.
All versions require rsc.io/quote so we can test downgrades.

v2.0.0 is technically part of example.com/latemigrate as v2.0.0+incompatible.
Proxies may serve it as part of the version list for example.com/latemigrate/v2.
'go get' must be able to ignore these versions.

-- .mod --
module example.com/latemigrate
-- .info --

所以 OpenAPI为了相似的目的定义了自己的 <a href="https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.3.md#fixed-fields-20" class="external-link" target="_blank">`example`</a> (使用 `example`, 而不是 `examples`), 这也是文档 UI 所使用的 (使用 Swagger UI).

所以，虽然 `example` 不是JSON Schema的一部分，但它是OpenAPI的一部分，这将被文档UI使用。

## 其他信息

with the same version.

-- .mod --
module example.net/ambiguous

go 1.16
-- .info --
{"Version": "v0.2.0"}
-- go.mod --
module example.net/ambiguous

go 1.16
-- nested/pkg/README.txt --
// Package pkg no longer exists in this module at v0.2.0.