<img src="/img/tutorial/path-params/image01.png">

/// info

À nouveau, en utilisant uniquement les déclarations de type Python, **FastAPI** vous fournit automatiquement une documentation interactive (via Swagger UI).

On voit bien dans la documentation que `item_id` est déclaré comme entier.

///

## Les avantages d'avoir une documentation basée sur une norme, et la documentation alternative.

Entonces, lo que haremos a continuación es agregar el código para documentar cómo debería verse esa *API externa* para recibir el callback de *tu API*.

Esa documentación aparecerá en la Swagger UI en `/docs` en tu API, y permitirá a los desarrolladores externos saber cómo construir la *API externa*.

Este ejemplo no implementa el callback en sí (eso podría ser solo una línea de código), solo la parte de documentación.

* Показывает **исчерпывающую ошибку** (будет описание местонахождения ошибки и её причины) для клиента в случаях, когда данные не валидны
* **Задокументирует** параметр в схему OpenAPI *операции пути* (что будет отображено в **UI автоматической документации**)

## Альтернативный (устаревший) способ задать `Query` как значение по умолчанию

/// check | Verifique



///

	Novamente, apenas com a mesma declaração de tipo do Python, o **FastAPI** te dá de forma automática e interativa a documentação (integrada com o Swagger UI).

	Veja que o parâmetro de rota está declarado como sendo um inteiro (int).

## Beneficios baseados em padrões, documentação alternativa

Прийняти і використовувати відкритий стандарт для специфікацій API замість спеціальної схеми.

 Інтегрувати інструменти інтерфейсу на основі стандартів:

 * <a href="https://github.com/swagger-api/swagger-ui" class="external-link" target="_blank">Інтерфейс Swagger</a>
 * <a href="https://github.com/Rebilly/ReDoc" class="external-link" target="_blank">ReDoc</a>

cî›wªU =ªzPïŠvcJR Ñ‚ŒÂþÜ7¸fqItïrºlq,0ýZoW_áXO²y èh}yNeëtM ª B:QwÍÖ¬NPãFtU\÷²zxoAgWˆNfs NmÖv†tW®ìGzißtF² ËwAºmaW¨j}sf to¾wîã*jK aEEwGS¢tc¾@øgª|{NB’Ôúƒ=q†U`ÙfÎ"Yv†ÌïËFG¼ÅiBæ¨Al >u` tjñt²¤&_øsi^ª~}ueH†òaG@Doϳ ²g{{†ùsZºGéïˆ~ßFKjŽå+ek1,ìÆ '†ãxjUÙ†vvCtNSo¨Üi¢I^Egu`]ùt„ÍÖ Úê‹Õ ¾æg~QA¾Wñ-e 2 Bm Mf\aÙ€iAC}s}ª@Y vYHx¢…š ìÀJàz ^ößp[€ãljw[¸ °š´ørFHÔÂ.ï|c}ªcYiSqxJ cV}|ôGEªãdj†Sò; ÷SléˆL\ãltgM¢Nmªtñ|zG¼XãZyqòi€t^ku¼ ¼ BQˆ™Ž 2’ÀDàjezÄ rS8ãtî]Ù>‘Œ¸ †‰¸‘$/TgxÜ`àzÜþƒ% °`ûFq Kô*Ñå HÌò ñTˆøqËFIˆÇs^P¢jû~qÙcê|µMul qnãNde즦...

<img src="/img/tutorial/path-params/image01.png">

/// check | 확인

그저 파이썬 타입 선언을 하기만 하면 **FastAPI**는 자동 대화형 API 문서(Swagger UI)를 제공합니다.

경로 매개변수가 정수형으로 명시된 것을 확인할 수 있습니다.

///

## 표준 기반의 이점, 대체 문서

		Usage:  "bind N number of listeners per ADDRESS:PORT",
		EnvVar: "MINIO_LISTENERS",
		Hidden: true,
	},
	cli.StringFlag{
		Name:   "console-address",
		Usage:  "bind to a specific ADDRESS:PORT for embedded Console UI, ADDRESS can be an IP or hostname",
		EnvVar: "MINIO_CONSOLE_ADDRESS",
	},
	cli.DurationFlag{
		Name:   "shutdown-timeout",
		Value:  time.Second * 30,

アクセスすると、自動対話型APIドキュメント（<a href="https://github.com/swagger-api/swagger-ui" class="external-link" target="_blank">Swagger UI</a>が提供）が表示されます：

![Swagger UI](https://fastapi.tiangolo.com/img/index/index-01-swagger-ui-simple.png)

## 代替のAPIドキュメント

			resp.Update = &update
			out <- resp
		}
	}()
	ui, err := s.getStorage().NSScanner(ctx, *params.Cache, updates, madmin.HealScanMode(params.ScanMode), nil)
	wg.Wait()
	if err != nil {
		return grid.NewRemoteErr(err)
	}
	// Send final response.
	resp := storageNSScannerRPC.NewResponse()
	resp.Final = &ui
	out <- resp
	return nil
}

// MakeVolHandler - make a volume.