Swagger UI s’en chargera en arrière‑plan pour vous, mais il a besoin de cet assistant « redirect ».

///

### Créer un chemin d'accès pour tester { #create-a-path-operation-to-test-it }

Maintenant, pour pouvoir vérifier que tout fonctionne, créez un chemin d'accès :

{* ../../docs_src/custom_docs_ui/tutorial001_py310.py hl[36:38] *}

### Tester { #test-it }

FastAPI artık şunları yapacak:

* Verinin uzunluğunun en fazla 50 karakter olduğundan emin olacak şekilde **doğrulayacak**
* Veri geçerli değilse client için **net bir hata** gösterecek
* Parametreyi OpenAPI şemasındaki *path operation* içinde **dokümante edecek** (dolayısıyla **otomatik dokümantasyon arayüzünde** görünecek)

## Alternatif (eski): Varsayılan değer olarak `Query` { #alternative-old-query-as-the-default-value }

Si el token es inválido, devuelve un error HTTP de inmediato.

{* ../../docs_src/security/tutorial004_an_py310.py hl[93:110] *}

## Actualizar la *path operation* `/token` { #update-the-token-path-operation }

Crea un `timedelta` con el tiempo de expiración del token.

Crea un verdadero token de acceso JWT y devuélvelo.

{* ../../docs_src/security/tutorial004_an_py310.py hl[121:136] *}

因此，如其官網所言：

> Requests is one of the most downloaded Python packages of all time

用法非常簡單。例如，發出一個 `GET` 請求，你會寫：

```Python
response = requests.get("http://example.com/some/url")
```

相對地，FastAPI 的 API 路徑操作（path operation）可能像這樣：

```Python hl_lines="1"
@app.get("/some/url")
def read_url():
    return {"message": "Hello World"}
```

看看 `requests.get(...)` 與 `@app.get(...)` 的相似之處。

/// check | 啟發 **FastAPI**

Por ejemplo, para declarar un header de `X-Token` que puede aparecer más de una vez, puedes escribir:

{* ../../docs_src/header_params/tutorial003_an_py310.py hl[9] *}

Si te comunicas con esa *path operation* enviando dos headers HTTP como:

```
X-Token: foo
X-Token: bar
```

El response sería como:

```JSON
{
    "X-Token values": [
        "bar",
        "foo"
    ]
}
```

            doc.put(fessConfig.getResponseFieldUrlLink(), ComponentUtil.getViewHelper().getUrlLink(doc));
        }
    }

    /**
     * Result of a search operation, including queryId and requestedTime.
     */
    protected static class ChatSearchResult {
        private final List<Map<String, Object>> documents;
        private final String queryId;

///

### Неасинхронные функции-обработчики пути { #non-async-path-operation-functions }

Вы также можете использовать обычные функции `def` (без `async`) и использовать `yield` таким же образом.

FastAPI обеспечит корректное выполнение так, чтобы это не блокировало цикл событий.

/// tip | Порада

Оскільки Pydantic серіалізуватиме це на боці **Rust**, ви отримаєте значно вищу **продуктивність**, ніж якби не оголошували тип повернення.

///

### Не-async *функції операцій шляху* { #non-async-path-operation-functions }

Ви також можете використовувати звичайні функції `def` (без `async`) і використовувати `yield` так само.

FastAPI подбає про коректне виконання, щоб це не блокувало цикл подій.

/// tip | Порада

Зверніть увагу, що так само як і для [залежностей у декораторах *операцій шляху*](dependencies/dependencies-in-path-operation-decorators.md), жодне значення не буде передано вашій *функції операції шляху*.

///

У підсумку шляхи предметів тепер:

* `/items/`
* `/items/{item_id}`

...як ми і планували.

API를 OAuth2 provider와 통합하면 인증을 수행한 뒤 획득한 자격 증명으로 API 문서로 다시 돌아올 수 있습니다. 그리고 실제 OAuth2 인증을 사용해 API와 상호작용할 수 있습니다.

Swagger UI가 이 과정을 백그라운드에서 처리해 주지만, 이를 위해 이 "redirect" 헬퍼가 필요합니다.

///

### 테스트용 *경로 처리* 만들기 { #create-a-path-operation-to-test-it }

이제 모든 것이 제대로 동작하는지 테스트할 수 있도록 *경로 처리*를 하나 만드세요:

{* ../../docs_src/custom_docs_ui/tutorial001_py310.py hl[36:38] *}

### 테스트하기 { #test-it }