# 中繼資料與文件 URL { #metadata-and-docs-urls }

你可以在你的 FastAPI 應用程式中自訂多項中繼資料設定。

## API 的中繼資料 { #metadata-for-api }

你可以設定下列欄位，這些欄位會用在 OpenAPI 規格與自動產生的 API 文件介面中：

| 參數 | 型別 | 說明 |
|------------|------|-------------|
| `title` | `str` | API 的標題。 |
| `summary` | `str` | API 的簡短摘要。<small>自 OpenAPI 3.1.0、FastAPI 0.99.0 起可用。</small> |
| `description` | `str` | API 的簡短說明。可使用 Markdown。 |
| `version` | `string` | API 的版本號。這是你自己的應用程式版本，不是 OpenAPI 的版本，例如 `2.5.0`。 |

        map sigbuild-r2.17-clang-python3.12 2.17-python3.12
    - name: Create Pull Request with changes
      uses: peter-evans/create-pull-request@98357b18bf14b5342f975ff684046ec3b2a07725 # v8.0.0
      with:
        title: Update the RBE images to the latest container versions
        committer: TensorFlow Release Automation <******@****.***>
        token: ${{ secrets.JENKINS_TOKEN }}

        List<Map<String, Object>> documentItems = new ArrayList<>();
        Map<String, Object> doc1 = new HashMap<>();
        doc1.put("docId", "doc1");
        doc1.put("title", "Test Document 1");
        documentItems.add(doc1);

        try {
            userInfoHelper.storeQueryId("query1", documentItems);
            assertTrue(true);
        } catch (Exception e) {

Vous pouvez définir les champs suivants qui sont utilisés dans la spécification OpenAPI et les interfaces utilisateur de documentation automatique de l’API :

| Paramètre | Type | Description |
|------------|------|-------------|
| `title` | `str` | Le titre de l’API. |
| `summary` | `str` | Un court résumé de l’API. <small>Disponible depuis OpenAPI 3.1.0, FastAPI 0.99.0.</small> |
| `description` | `str` | Une brève description de l’API. Elle peut utiliser Markdown. |

Если вы хотите узнать больше об этих кодировках и полях форм, перейдите по ссылке [<abbr title="Mozilla Developer Network - Сеть разработчиков Mozilla">MDN</abbr> web docs for `POST`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/POST).

///

/// warning | Внимание

在這種情況下，中介軟體會攔截傳入的請求並回應適當的 CORS 標頭，並回傳 `200` 或 `400`（僅供資訊參考）。

### 簡單請求 { #simple-requests }

任何帶有 `Origin` 標頭的請求。在這種情況下，中介軟體會如常將請求往下傳遞，但會在回應上加入適當的 CORS 標頭。

## 更多資訊 { #more-info }

想進一步了解 <abbr title="Cross-Origin Resource Sharing - 跨來源資源共用">CORS</abbr>，請參考 [Mozilla 的 CORS 文件](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS)。

/// note | 技術細節

你也可以使用 `from starlette.middleware.cors import CORSMiddleware`。

labels.user_name=Nama Pengguna
labels.login=Masuk
labels.login.placeholder_username=Nama Pengguna
labels.login.placeholder_password=Kata Sandi
labels.login.title=Masuk
labels.index_label=Label
labels.index_lang=Bahasa Pilihan
labels.index_sort=Sortir
labels.index_num=Jumlah Tampilan
labels.logout_title=Keluar
labels.logout=Keluar

labels.user_name=Nazwa użytkownika
labels.login=Zaloguj się
labels.login.placeholder_username=Nazwa użytkownika
labels.login.placeholder_password=Hasło
labels.login.title=Zaloguj się
labels.index_label=Etykieta
labels.index_lang=Preferowany język
labels.index_sort=Sortuj
labels.index_num=Liczba wyników
labels.logout_title=Wyloguj się
labels.logout=Wyloguj się

labels.user_name=Kullanıcı Adı
labels.login=Oturum Aç
labels.login.placeholder_username=Kullanıcı Adı
labels.login.placeholder_password=Şifre
labels.login.title=Oturum Aç
labels.index_label=Etiket
labels.index_lang=Tercih Edilen Dil
labels.index_sort=Sırala
labels.index_num=Gösterim Sayısı
labels.logout_title=Oturumu Kapat
labels.logout=Oturumu Kapat

---
title: Recipes
description: A collection of common/useful code examples for Kotlin and Java
---


# Recipes

We've written some recipes that demonstrate how to solve common problems with OkHttp. Read through them to learn about how everything works together. Cut-and-paste these examples freely; that's what they're for.

### Synchronous Get ([.kt][SynchronousGetKotlin], [.java][SynchronousGetJava])