app = FastAPI()


class Item(BaseModel):
    name: str
    description: str | None = None
    price: float
    tax: float | None = None
    tags: set[str] = set()


@app.post("/items/", summary="Create an item")
async def create_item(item: Item) -> Item:
    """
    Create an item with all the information:

    - **name**: each item must have a name
    - **description**: a long description

from pydantic import BaseModel

app = FastAPI()


class Item(BaseModel):
    name: str
    description: str | None = None
    price: float
    tax: float | None = None


@app.put("/items/{item_id}")
async def update_item(
    *,
    item_id: int = Path(title="The ID of the item to get", ge=0, le=1000),
    q: str | None = None,
    item: Item | None = None,
):
    results = {"item_id": item_id}

async def verify_key(x_key: Annotated[str, Header()]):
    if x_key != "fake-super-secret-key":
        raise HTTPException(status_code=400, detail="X-Key header invalid")
    return x_key


@app.get("/items/", dependencies=[Depends(verify_token), Depends(verify_key)])
async def read_items():

import org.gradle.work.DisableCachingByDefault
import java.net.URI
import java.net.http.HttpClient
import java.net.http.HttpRequest
import java.net.http.HttpResponse


data class GitHubPullRequestSearchResult(val items: List<GitHubPullRequest>)


data class GitHubUser(val login: String, val name: String?)


data class GitHubPullRequestMilestone(val title: String)


data class GitHubPullRequest(
    val number: Int,

    ## Example

    ```python
    from fastapi import Depends, FastAPI
    from fastapi.security import APIKeyQuery

    app = FastAPI()

    query_scheme = APIKeyQuery(name="api_key")


    @app.get("/items/")
    async def read_items(api_key: str = Depends(query_scheme)):
        return {"api_key": api_key}
    ```
    """

    def __init__(
        self,
        *,
        name: Annotated[
            str,

import org.apache.maven.api.annotations.Experimental;

/**
 * Enumeration defining different retention periods for cached data.
 * Each value represents a specific scope and lifetime for cached items.
 *
 * @since 4.0.0
 */
@Experimental
public enum CacheRetention {
    /**
     * Data should be persisted across Maven invocations.
     * Suitable for:
     * - Dependency resolution results

                                    <la:select styleId="fileName" property="fileName" styleClass="form-control">
                                        <c:forEach var="item" varStatus="s" items="${fileNameItems}">
                                            <la:option value="${item}">${f:h(item)}</la:option>
                                        </c:forEach>
                                    </la:select>

                                            <tbody>
                                            <c:forEach var="data" varStatus="s"
                                                       items="${labelTypeItems}">
                                                <tr
                                                        data-href="${contextPath}/admin/labeltype/details/4/${f:u(data.id)}" role="button" tabindex="0">

# エディタ対応 { #editor-support }

公式の[FastAPI Extension](https://marketplace.visualstudio.com/items?itemName=FastAPILabs.fastapi-vscode)は、*path operation* の検出・ナビゲーションに加え、FastAPI Cloud へのデプロイやライブログストリーミングなど、FastAPI の開発ワークフローを強化します。

拡張機能の詳細は、[GitHub リポジトリ](https://github.com/fastapi/fastapi-vscode)の README を参照してください。

## セットアップとインストール { #setup-and-installation }

    * `description`: harici dokümanlar için kısa açıklama içeren `str`.
    * `url` (**zorunlu**): harici dokümantasyonun URL'sini içeren `str`.

### Tag'ler için metadata oluşturun { #create-metadata-for-tags }

`users` ve `items` tag'lerini içeren bir örnekle deneyelim.

Tag'leriniz için metadata oluşturup `openapi_tags` parametresine geçin:

{* ../../docs_src/metadata/tutorial004_py310.py hl[3:16,18] *}