///

Він містить усю інформацію про *операцію шляху* і використовується для побудови автоматичної документації.

Він включає `tags`, `parameters`, `requestBody`, `responses` тощо.

Цю OpenAPI-схему, специфічну для *операції шляху*, зазвичай генерує **FastAPI** автоматично, але ви також можете її розширити.

/// tip | Порада

Це низькорівнева точка розширення.

            builder.allRecordCountRelation(Relation.EQUAL_TO.toString());
            return builder.build();
        }
    }

    /**
     * Test search request parameters implementation.
     */
    static class TestSearchRequestParams extends SearchRequestParams {
        private final int startPosition;
        private final int pageSize;
        private final int offset;

        assertFalse(thumbnailGenerator.isAvailable());
    }

    @Test
    public void test_createTask_withValidParams() {
        // Test task creation with valid parameters
        String path = "/path/to/document.pdf";
        Map<String, Object> docMap = new HashMap<>();
        docMap.put("mimetype", "application/pdf");
        docMap.put("title", "Test Document");

{* ../../docs_src/pydantic_v1_in_v2/tutorial003_an_py310.py hl[2:3,6,12,21:22] *}

위 예제에서 입력 모델은 Pydantic v1 모델이고, 출력 모델(`response_model=ItemV2`로 정의됨)은 Pydantic v2 모델입니다.

### Pydantic v1 파라미터 { #pydantic-v1-parameters }

Pydantic v1 모델과 함께 `Body`, `Query`, `Form` 등 파라미터용 FastAPI 전용 도구 일부를 사용해야 한다면, Pydantic v2로의 마이그레이션을 마칠 때까지 `fastapi.temp_pydantic_v1_params`에서 import할 수 있습니다:

OpenAPI 명세에서는 이를 [Operation Object](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#operation-object)라고 부릅니다.

///

여기에는 *경로 처리*에 대한 모든 정보가 있으며, 자동 문서를 생성하는 데 사용됩니다.

`tags`, `parameters`, `requestBody`, `responses` 등이 포함됩니다.

이 *경로 처리* 전용 OpenAPI 스키마는 보통 **FastAPI**가 자동으로 생성하지만, 확장할 수도 있습니다.

/// tip | 팁

이는 저수준 확장 지점입니다.

	var tmp snowball
	err := val.Decode(&tmp)
	if err != nil {
		return err
	}

	*b = BatchJobSnowball(tmp)
	b.line, b.col = val.Line, val.Column
	return nil
}

// Validate the snowball parameters in the job description
func (b BatchJobSnowball) Validate() error {
	if *b.Batch <= 0 {
		return BatchJobYamlErr{
			line: b.line,
			col:  b.col,
			msg:  "batch number should be non positive zero",
		}

	credElement := strings.TrimPrefix(strings.Split(strings.TrimSpace(v4Auth), ",")[0], signV4Algorithm)
	// Replace all spaced strings, some clients can send spaced
	// parameters and some won't. So we pro-actively remove any spaces
	// to make parsing easier.
	v4Auth = strings.ReplaceAll(v4Auth, " ", "")
	if v4Auth == "" {
		return sv, ErrAuthHeaderEmpty
	}

    //                                                                      ==============

    /**
     * Retrieves web configuration settings with pagination.
     *
     * @param body the search parameters for filtering and pagination
     * @return JSON response containing web configuration settings list
     */
    // GET /api/admin/webconfig/settings
    // PUT /api/admin/webconfig/settings
    @Execute

Si elle ne le reçoit pas, elle renvoie une erreur HTTP 401 « Unauthorized ».

Et elle renvoie un en-tête `WWW-Authenticate` avec la valeur `Basic`, et un paramètre optionnel `realm`.

Cela indique au navigateur d'afficher l'invite intégrée pour saisir un nom d'utilisateur et un mot de passe.

```

///

## `Form`のインポート { #import-form }

`fastapi`から`Form`をインポートします:

{* ../../docs_src/request_forms/tutorial001_an_py310.py hl[3] *}

## `Form`のパラメータの定義 { #define-form-parameters }

`Body`や`Query`の場合と同じようにフォームパラメータを作成します:

{* ../../docs_src/request_forms/tutorial001_an_py310.py hl[9] *}

例えば、OAuth2仕様が使用できる方法の１つ（「パスワードフロー」と呼ばれる）では、フォームフィールドとして`username`と`password`を送信する必要があります。