# 路径操作的高级配置 { #path-operation-advanced-configuration }

## OpenAPI 的 operationId { #openapi-operationid }

/// warning

如果你并非 OpenAPI 的“专家”，你可能不需要这部分内容。

///

你可以在 *路径操作* 中通过参数 `operation_id` 设置要使用的 OpenAPI `operationId`。

务必确保每个操作的 `operation_id` 都是唯一的。

{* ../../docs_src/path_operation_advanced_configuration/tutorial001_py310.py hl[6] *}

### 使用 *路径操作函数* 的函数名作为 operationId { #using-the-path-operation-function-name-as-the-operationid }

En algunos casos realmente no necesitas el valor de retorno de una dependencia dentro de tu *path operation function*.

O la dependencia no devuelve un valor.

Pero aún necesitas que sea ejecutada/resuelta.

Para esos casos, en lugar de declarar un parámetro de *path operation function* con `Depends`, puedes añadir una `list` de `dependencies` al decorador de *path operation*.

# Залежності в декораторах операцій шляху { #dependencies-in-path-operation-decorators }

Іноді вам насправді не потрібне значення, яке повертає залежність, у вашій *функції операції шляху*.

Або залежність узагалі не повертає значення.

Але її все одно потрібно виконати/опрацювати.

Для таких випадків, замість оголошення параметра *функції операції шляху* з `Depends`, ви можете додати `list` `dependencies` до *декоратора операції шляху*.

# path operation デコレータの依存関係 { #dependencies-in-path-operation-decorators }

場合によっては、*path operation 関数*の中で依存関係の戻り値を実際には必要としないことがあります。

または、依存関係が値を返さない場合もあります。

しかし、それでも実行・解決される必要があります。

そのような場合、`Depends` で *path operation 関数* のパラメータを宣言する代わりに、*path operation デコレータ*に `dependencies` の `list` を追加できます。

## *path operation デコレータ*に`dependencies`を追加 { #add-dependencies-to-the-path-operation-decorator }

*path operation デコレータ*はオプション引数`dependencies`を受け取ります。

# Abhängigkeiten in Pfadoperation-Dekoratoren { #dependencies-in-path-operation-decorators }

Manchmal benötigen Sie den Rückgabewert einer Abhängigkeit innerhalb Ihrer *Pfadoperation-Funktion* nicht wirklich.

Oder die Abhängigkeit gibt keinen Wert zurück.

Aber Sie müssen sie trotzdem ausführen/auflösen.

        var timestamp = formatTimestamp(new Date());

        var html =
            '<div class="chat-message ' + role + '">' +
                '<div class="message-avatar"><i class="fa ' + avatarIcon + '" aria-hidden="true"></i></div>' +
                '<div class="message-wrapper">' +
                    '<div class="message-content">' +

# 路徑參數 { #path-parameters }

你可以用與 Python 格式化字串相同的語法來宣告路徑「參數」或「變數」：

{* ../../docs_src/path_params/tutorial001_py310.py hl[6:7] *}

路徑參數 `item_id` 的值會作為引數 `item_id` 傳入你的函式。

所以，如果你執行這個範例並前往 [http://127.0.0.1:8000/items/foo](http://127.0.0.1:8000/items/foo)，你會看到這樣的回應：

```JSON
{"item_id":"foo"}
```

## 具型別的路徑參數 { #path-parameters-with-types }

你可以在函式中使用標準的 Python 型別註記為路徑參數宣告型別：

  <dependencies>
    <dependency>
      <groupId>test</groupId>
      <artifactId>a</artifactId>
      <version>0.2</version>
      <scope>system</scope>
      <systemPath>should-use-variables-and-not-hard-code-this-path</systemPath>
    </dependency>
    <dependency>
      <groupId>test</groupId>
      <artifactId>b</artifactId>
      <version>0.1</version>
      <scope>system</scope>

Quoc Truong <******@****.***> 1727209746 -0700

# Dependências em decoradores de operações de rota { #dependencies-in-path-operation-decorators }

Em alguns casos você não precisa necessariamente do valor de retorno de uma dependência dentro de uma *função de operação de rota*.

Ou a dependência não retorna nenhum valor.

Mas você ainda precisa que ela seja executada/resolvida.