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

/// check | 確認

繰り返しになりますが、Python型宣言を使用するだけで、**FastAPI**は対話的なAPIドキュメントを自動的に生成します（Swagger UIを統合）。

パスパラメータが整数として宣言されていることに注意してください。

///

## 標準であることのメリット、ドキュメンテーションの代替物

* **валидировать** данные, удостоверяясь, что максимальная длина — 50 символов;
* показывать **понятную ошибку** клиенту, если данные невалидны;
* **документировать** параметр в *операции пути* схемы OpenAPI (он будет показан в **UI автоматической документации**).

## Альтернатива (устаревшее): `Query` как значение по умолчанию { #alternative-old-query-as-the-default-value }

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즦...

Это демонстрирует, как прокси (Traefik) использует префикс пути и как сервер (Uvicorn) использует `root_path`, переданный через опцию `--root-path`.

### Проверьте интерфейс документации { #check-the-docs-ui }

А вот самое интересное. ✨

* Mostrar um **erro claro** para o cliente quando os dados não forem válidos
* **Documentar** o parâmetro na *operação de rota* do esquema OpenAPI (então ele aparecerá na **UI de docs automática**)

## Alternativa (antiga): `Query` como valor padrão { #alternative-old-query-as-the-default-value }

Dies demonstriert, wie der Proxy (Traefik) das Pfadpräfix verwendet und wie der Server (Uvicorn) den `root_path` aus der Option `--root-path` verwendet.

### Es in der Dokumentationsoberfläche testen { #check-the-docs-ui }

Jetzt folgt der spaßige Teil. ✨

アクセスすると、自動対話型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ドキュメント

			configLogIf(ctx, fmt.Errorf("Unable to parse subnet configuration: %w", err))
		} else {
			globalSubnetConfig.Update(subnetConfig, globalIsCICD)
			globalSubnetConfig.ApplyEnv() // update environment settings for Console UI
		}
	case config.CallhomeSubSys:
		callhomeCfg, err := callhome.LookupConfig(s[config.CallhomeSubSys][config.Default])
		if err != nil {
			configLogIf(ctx, fmt.Errorf("Unable to load callhome config: %w", err))

			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.

* Mostrará un **error claro** para el cliente cuando los datos no sean válidos
* **Documentará** el parámetro en el OpenAPI esquema *path operation* (así aparecerá en la **UI de documentación automática**)

## Alternativa (antigua): `Query` como valor por defecto { #alternative-old-query-as-the-default-value }