Statuscode - Code Search

docs/ko/docs/advanced/response-change-status-code.md

이런 경우에는 `Response` 파라미터를 사용할 수 있습니다.

## `Response` 파라미터 사용하기

*경로 작동 함수*에 `Response` 타입의 파라미터를 선언할 수 있습니다. (쿠키와 헤더에 대해 선언하는 것과 유사하게)

그리고 이 *임시* 응답 객체에서 `status_code`를 설정할 수 있습니다.

{* ../../docs_src/response_change_status_code/tutorial001.py hl[1,9,12] *}

그리고 평소처럼 원하는 객체(`dict`, 데이터베이스 모델 등)를 반환할 수 있습니다.

`response_model`을 선언했다면 반환된 객체는 여전히 필터링되고 변환됩니다.

Registered: Sun Dec 28 07:19:09 UTC 2025

- Last Modified: Mon Nov 18 02:25:44 UTC 2024

- 1.7K bytes

- Viewed (0)

github.com/tiangolo/fastapi

docs/pt/docs/advanced/additional-status-codes.md

Mas você também deseja aceitar novos itens. E quando os itens não existiam, ele os cria, e retorna o código de status HTTP 201 "Created".

Para conseguir isso, importe `JSONResponse` e retorne o seu conteúdo diretamente, definindo o `status_code` que você deseja:

{* ../../docs_src/additional_status_codes/tutorial001_an_py310.py hl[4,25] *}

/// warning | Atenção

Registered: Sun Dec 28 07:19:09 UTC 2025

- Last Modified: Wed Nov 12 16:23:57 UTC 2025

- 2.2K bytes

- Viewed (0)

github.com/tiangolo/fastapi

tests/test_request_body_parameters_media_type.py

):
    pass  # pragma: no cover


client = TestClient(app)


def test_openapi_schema():
    response = client.get("/openapi.json")
    assert response.status_code == 200, response.text
    assert response.json() == {
        "openapi": "3.1.0",
        "info": {"title": "FastAPI", "version": "0.1.0"},
        "paths": {
            "/products": {
                "post": {

Registered: Sun Dec 28 07:19:09 UTC 2025

- Last Modified: Wed Dec 17 21:25:59 UTC 2025

- 6.3K bytes

- Viewed (0)

github.com/tiangolo/fastapi

scripts/sponsors.py

        github_graphql_url,
        headers=headers,
        timeout=settings.httpx_timeout,
        json={"query": query, "variables": variables, "operationName": "Q"},
    )
    if response.status_code != 200:
        logging.error(f"Response was not 200, after: {after}")
        logging.error(response.text)
        raise RuntimeError(response.text)
    data = response.json()
    if "errors" in data:

Registered: Sun Dec 28 07:19:09 UTC 2025

- Last Modified: Tue Dec 16 12:34:01 UTC 2025

- 6.1K bytes

- Viewed (0)

github.com/tiangolo/fastapi

scripts/contributors.py

        github_graphql_url,
        headers=headers,
        timeout=settings.httpx_timeout,
        json={"query": query, "variables": variables, "operationName": "Q"},
    )
    if response.status_code != 200:
        logging.error(f"Response was not 200, after: {after}")
        logging.error(response.text)
        raise RuntimeError(response.text)
    data = response.json()
    if "errors" in data:

Registered: Sun Dec 28 07:19:09 UTC 2025

- Last Modified: Tue Dec 16 12:34:01 UTC 2025

- 8.6K bytes

- Viewed (0)

github.com/tiangolo/fastapi

docs/ko/docs/advanced/additional-status-codes.md

예를 들어 항목을 업데이트할 수 있는 *경로 작업*이 있고 성공 시 200 “OK”의 HTTP 상태 코드를 반환한다고 가정해 보겠습니다.

하지만 새로운 항목을 허용하기를 원할 것입니다. 항목이 이전에 존재하지 않았다면 이를 생성하고 HTTP 상태 코드 201 "Created"를 반환합니다.

이를 위해서는 `JSONResponse`를 가져와서 원하는 `status_code`를 설정하여 콘텐츠를 직접 반환합니다:

{* ../../docs_src/additional_status_codes/tutorial001_an_py310.py hl[4,25] *}

/// warning | 경고

위의 예제처럼 `Response`를 직접 반환하면 바로 반환됩니다.

모델 등과 함께 직렬화되지 않습니다.

Registered: Sun Dec 28 07:19:09 UTC 2025

- Last Modified: Mon Dec 09 12:22:47 UTC 2024

- 2.1K bytes

- Viewed (0)

github.com/tiangolo/fastapi

tests/test_sub_callbacks.py

client = TestClient(app)


def test_get():
    response = client.post(
        "/invoices/", json={"id": "fooinvoice", "customer": "John", "total": 5.3}
    )
    assert response.status_code == 200, response.text
    assert response.json() == {"msg": "Invoice received"}


def test_openapi_schema():
    with client:
        response = client.get("/openapi.json")
        assert response.json() == {

Registered: Sun Dec 28 07:19:09 UTC 2025

- Last Modified: Sat Dec 27 18:19:10 UTC 2025

- 12.9K bytes

- Viewed (0)

github.com/tiangolo/fastapi

docs/zh/docs/advanced/additional-status-codes.md

如果你想要返回主要状态码之外的状态码，你可以通过直接返回一个 `Response` 来实现，比如 `JSONResponse`，然后直接设置额外的状态码。

例如，假设你想有一个 *路径操作* 能够更新条目，并且更新成功时返回 200 「成功」 的 HTTP 状态码。

但是你也希望它能够接受新的条目。并且当这些条目不存在时，会自动创建并返回 201 「创建」的 HTTP 状态码。

要实现它，导入 `JSONResponse`，然后在其中直接返回你的内容，并将 `status_code` 设置为为你要的值。

{* ../../docs_src/additional_status_codes/tutorial001.py hl[4,25] *}

/// warning | 警告

当你直接返回一个像上面例子中的 `Response` 对象时，它会直接返回。

FastAPI 不会用模型等对该响应进行序列化。

Registered: Sun Dec 28 07:19:09 UTC 2025

- Last Modified: Mon Nov 18 02:25:44 UTC 2024

- 1.8K bytes

- Viewed (0)

github.com/tiangolo/fastapi

tests/test_tutorial/test_websockets/test_tutorial002.py

    mod = importlib.import_module(f"docs_src.websockets.{request.param}")

    return mod.app


def test_main(app: FastAPI):
    client = TestClient(app)
    response = client.get("/")
    assert response.status_code == 200, response.text
    assert b"<!DOCTYPE html>" in response.content


def test_websocket_with_cookie(app: FastAPI):
    client = TestClient(app, cookies={"session": "fakesession"})

Registered: Sun Dec 28 07:19:09 UTC 2025

- Last Modified: Wed Dec 17 20:41:43 UTC 2025

- 4.1K bytes

- Viewed (0)

github.com/tiangolo/fastapi

docs/ko/docs/tutorial/path-operation-configuration.md

# 경로 작동 설정

*경로 작동 데코레이터*를 설정하기 위해서 전달할수 있는 몇 가지 매개변수가 있습니다.

/// warning | 경고

아래 매개변수들은 *경로 작동 함수*가 아닌 *경로 작동 데코레이터*에 직접 전달된다는 사실을 기억하십시오.

///

## 응답 상태 코드

*경로 작동*의 응답에 사용될 (HTTP) `status_code`를 정의할수 있습니다.

`404`와 같은 `int`형 코드를 직접 전달할수 있습니다.

하지만 각 코드의 의미를 모른다면, `status`에 있는 단축 상수들을 사용할수 있습니다:

{* ../../docs_src/path_operation_configuration/tutorial001.py hl[3,17] *}

각 상태 코드들은 응답에 사용되며, OpenAPI 스키마에 추가됩니다.

Registered: Sun Dec 28 07:19:09 UTC 2025

- Last Modified: Mon Nov 18 02:25:44 UTC 2024

- 3.9K bytes

- Viewed (0)

Search Options