# GraphQL { #graphql }

**FastAPI** は **ASGI** 標準に基づいているため、ASGI に対応した任意の **GraphQL** ライブラリを簡単に統合できます。

同じアプリケーション内で通常の FastAPI の *path operation* と GraphQL を組み合わせて使えます。

/// tip | 豆知識

**GraphQL** は非常に特定のユースケースを解決します。

一般的な **Web API** と比べると、**長所** と **短所** があります。

ご自身のユースケースで得られる **利点** が **欠点** を補うかどうかを評価してください。 🤓

///

## GraphQL ライブラリ { #graphql-libraries }

```

SSE; yapay zekâ sohbet akışı, canlı bildirimler, log ve gözlemlenebilirlik (observability) gibi senaryolarda ve sunucunun istemciye güncellemeleri ittiği diğer durumlarda yaygın olarak kullanılır.

/// tip | İpucu

İkili (binary) veri akışı yapmak istiyorsanız, gelişmiş kılavuza bakın: [Veri Akışı](../advanced/stream-data.md).

///

## FastAPI ile SSE Akışı { #stream-sse-with-fastapi }

data: {"name": "Plumbus", "price": 32.99}

```

SSE часто используют для стриминга ответов ИИ в чатах, живых уведомлений, логов и наблюдаемости, а также в других случаях, когда сервер «проталкивает» обновления клиенту.

/// tip | Совет

Если вам нужно стримить бинарные данные, например видео или аудио, посмотрите расширенное руководство: [Stream Data](../advanced/stream-data.md).

///

## Стриминг SSE с FastAPI { #stream-sse-with-fastapi }

# Umgebungsvariablen { #environment-variables }

/// tip | Tipp

Wenn Sie bereits wissen, was „Umgebungsvariablen“ sind und wie man sie verwendet, können Sie dies überspringen.

///

Eine Umgebungsvariable (auch bekannt als „**env var**“) ist eine Variable, die **außerhalb** des Python-Codes im **Betriebssystem** lebt und von Ihrem Python-Code (oder auch von anderen Programmen) gelesen werden kann.

    "paths": {
            // 여기에 다른 내용이 더 있습니다
    }
}
```

/// tip | 팁

`root_path`에서 가져온 값인 `/api/v1`의 `url` 값을 가진, 자동 생성된 server에 주목하세요.

///

[http://127.0.0.1:9999/api/v1/docs](http://127.0.0.1:9999/api/v1/docs)의 docs UI에서는 다음처럼 보입니다:

<img src="/img/tutorial/behind-a-proxy/image03.png">

/// tip | 팁

docs UI는 선택한 server와 상호작용합니다.

///

/// note | 기술 세부사항

## Additional Features { #additional-features }

There are some extra features to handle security apart from the ones covered in the [Tutorial - User Guide: Security](../../tutorial/security/index.md).

/// tip

The next sections are **not necessarily "advanced"**.

And it's possible that for your use case, the solution is in one of them.

///

## Read the Tutorial first { #read-the-tutorial-first }

Si algo parece interesante y útil para tu proyecto, adelante y revísalo, pero de lo contrario, probablemente puedas simplemente omitirlas.

/// tip | Consejo

Si quieres **aprender FastAPI** de una manera estructurada (recomendado), ve y lee el [Tutorial - Guía de Usuario](../tutorial/index.md) capítulo por capítulo en su lugar.

#!/usr/bin/env bash

set -x

trap 'catch $LINENO' ERR

# shellcheck disable=SC2120
catch() {
	if [ $# -ne 0 ]; then
		echo "error on line $1"
		for site in sitea siteb; do
			echo "$site server logs ========="
			cat "/tmp/${site}_1.log"
			echo "==========================="
			cat "/tmp/${site}_2.log"
		done
	fi

	echo "Cleaning up instances of MinIO"
	pkill minio
	pkill -9 minio
	rm -rf /tmp/multisitea

        // 8 messages: 4 user/assistant pairs
        for (int i = 1; i <= 4; i++) {
            session.addUserMessage("User " + i);
            session.addAssistantMessage("Assistant " + i);
        }

        // Trim to 6 -> start at index 2 (User 2), which is user -> no skip
        session.trimHistory(6);

        final List<ChatMessage> messages = session.getMessages();
        assertEquals(6, messages.size());

Il existe des fonctionnalités supplémentaires pour gérer la sécurité en plus de celles couvertes dans le [Tutoriel - Guide utilisateur : Sécurité](../../tutorial/security/index.md).

/// tip | Astuce

Les sections suivantes **ne sont pas nécessairement « advanced »**.

Et il est possible que, pour votre cas d’utilisation, la solution se trouve dans l’une d’entre elles.

///