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

/// check | "確認"

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

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

///

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

* Show a **clear error** for the client when the data is not valid
* **Document** the parameter in the OpenAPI schema *path operation* (so it will show up in the **automatic docs UI**)

## Alternative (old): `Query` as the default value

def test_swagger_ui():
    response = client.get("/docs")
    assert response.status_code == 200, response.text
    assert response.headers["content-type"] == "text/html; charset=utf-8"
    assert "swagger-ui-dist" in response.text
    assert (
        "oauth2RedirectUrl: window.location.origin + '/docs/oauth2-redirect'"
        in response.text
    )


def test_swagger_ui_oauth2_redirect():

アクセスすると、自動対話型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.

			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))

	certsSet := ctxt.certsDirSet

	if globalBrowserEnabled {
		if consoleAddr == "" {
			p, err := xnet.GetFreePort()
			if err != nil {
				logger.FatalIf(err, "Unable to get free port for Console UI on the host")
			}
			// hold the port
			l, err := net.Listen("TCP", fmt.Sprintf(":%s", p.String()))
			if err == nil {
				defer l.Close()
			}
			consoleAddr = net.JoinHostPort("", p.String())
		}

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

/// check | "😮 **FastAPI** "

🛠️ & ⚙️ 📂 🐩 🛠️ 🔧, ↩️ 🛃 🔗.

 & 🛠️ 🐩-⚓️ 👩‍💻 🔢 🧰:

* <a href="https://github.com/swagger-api/swagger-ui" class="external-link" target="_blank">🦁 🎚</a>
* <a href="https://github.com/Rebilly/ReDoc" class="external-link" target="_blank">📄</a>

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

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