### Крок 3: створіть *операцію шляху* { #step-3-create-a-path-operation }

#### Шлях { #path }

«Шлях» тут означає останню частину URL, починаючи з першого `/`.

Отже, у такому URL, як:

```
https://example.com/items/foo
```

...шлях буде:

```
/items/foo
```

/// info

                * a `dict` with a `url` value of the application's mounting point
                (`root_path`) if it's different from `/`.
                * otherwise, the `servers` property will be omitted from the OpenAPI
                schema.

                Each item in the `list` is a `dict` containing:

                * `url`: A URL to the target host. This URL supports Server Variables

### 통합 테스트

Fess 서버를 시작하고 다음 명령을 실행합니다:

    $ mvn test -P integrationTests -Dtest.fess.url="http://localhost:8080" -Dtest.search_engine.url="http://localhost:9201"

단일 테스트 케이스를 실행하려면 다음을 사용할 수 있습니다:

    $ mvn test -P integrationTests -Dtest.fess.url="http://localhost:8080" -Dtest.search_engine.url="http://localhost:9201" -Dtest=SearchApiTests

### 언어 번역

Fess는 국제화된 소프트웨어입니다.

        final Map<String, Object> requestBody = new HashMap<>();
        // Keep original external URL for stable test results + failure URL for testing
        final String urls = "https://www.codelibs.org/" + "\n" + "http://failure.url";
        final String includedUrls = "https://www.codelibs.org/.*" + "\n" + "http://failure.url.*";
        requestBody.put("name", NAME_PREFIX + "WebConfig");
        requestBody.put("urls", urls);

    /**
     * Deletes all documents that match the specified URL.
     *
     * @param searchEngineClient the search engine client to use for deletion
     * @param url the URL to match for document deletion
     * @return the number of documents that were deleted
     */
    public long deleteDocumentByUrl(final SearchEngineClient searchEngineClient, final String url) {
        final FessConfig fessConfig = ComponentUtil.getFessConfig();

{* ../../docs_src/security/tutorial001_an_py310.py hl[8] *}

/// tip | 豆知識

ここで、`tokenUrl="token"`は、まだ作成していない相対URL`token`を指します。相対URLなので、`./token`と同じです。

相対URLを使っているので、APIが`https://example.com/`にある場合、`https://example.com/token`を参照します。しかし、APIが`https://example.com/api/v1/`にある場合は`https://example.com/api/v1/token`を参照することになります。

from fastapi import FastAPI
from pydantic import BaseModel, HttpUrl

app = FastAPI()


class Image(BaseModel):
    url: HttpUrl
    name: str


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


@app.put("/items/{item_id}")
async def update_item(item_id: int, item: Item):

        summary="This is a very custom OpenAPI schema",
        description="Here's a longer description of the custom **OpenAPI** schema",
        routes=app.routes,
    )
    openapi_schema["info"]["x-logo"] = {
        "url": "https://fastapi.tiangolo.com/img/logo-margin/logo-teal.png"
    }
    app.openapi_schema = openapi_schema
    return app.openapi_schema

Und **Ihre Benutzer** definieren auf irgendeine Weise (zum Beispiel irgendwo in einem Web-<abbr title="Benutzeroberfläche für das Visualisieren und Managen von Daten">Dashboard</abbr>) die **URL**, an die Ihre App diese Requests senden soll.

constraints.Range.message = {item} harus antara {min} dan {max}.
constraints.SafeHtml.message = {item} mengandung konten HTML yang tidak aman.
constraints.ScriptAssert.message = Ekspresi script "{script}" tidak benar.
constraints.URL.message = {item} bukan URL yang valid.
constraints.Required.message = {item} wajib diisi.
constraints.TypeInteger.message = {item} harus berupa angka.
constraints.TypeLong.message = {item} harus berupa angka.