@Resource
    private RoleService roleService;

    /**
     * Retrieves role settings with pagination.
     *
     * @param body the search parameters for filtering and pagination
     * @return JSON response containing role settings list
     */
    // GET /api/admin/role/settings
    // PUT /api/admin/role/settings
    @Execute
    public JsonResponse<ApiResult> settings(final SearchBody body) {

    -   לאמת שהוא כולל את מאפיין החובה `name` שאמור להיות מטיפוס `str`.
    -   לאמת שהוא כולל את מאפיין החובה `price` שחייב להיות מטיפוס `float`.
    -   לבדוק האם הוא כולל את מאפיין הרשות `is_offer` שאמור להיות מטיפוס `bool`, אם הוא נמצא.
    -   כל זה יעבוד גם לאובייקט JSON מקונן.
-   להמיר מ - JSON ול- JSON אוטומטית.
-   לתעד הכל באמצעות OpenAPI, תיעוד שבו יוכלו להשתמש:

    /**
     * Retrieves stemmer override dictionary settings with pagination support.
     *
     * @param dictId the dictionary ID
     * @param body the search body containing pagination and filter parameters
     * @return JSON response containing list of stemmer override dictionary items
     */
    // GET /api/admin/dict/stemmerOverride/settings/{dictId}
    @Execute

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

    /**
     * Retrieves the list of installed plugins.
     *
     * @return JSON response containing installed plugin list
     */
    // GET /api/admin/plugin/installed
    @Execute
    public JsonResponse<ApiResult> get$installed() {

## Convertir cualquier Dato a Compatible con JSON

Para convertir cualquier dato a compatible con JSON, lee la documentación para [Tutorial - Codificador Compatible con JSON](../tutorial/encoder.md){.internal-link target=_blank}.

## Metadatos OpenAPI - Documentación

///

## 토큰 반환하기

`token` 엔드포인트의 응답은 JSON 객체여야 합니다.

`token_type`이 있어야 합니다. 여기서는 "Bearer" 토큰을 사용하므로 토큰 유형은 "`bearer`"여야 합니다.

그리고 액세스 토큰을 포함하는 문자열과 함께 `access_token`이 있어야 합니다.

이 간단한 예제에서는 완전히 안전하지 않고, 동일한 `username`을 토큰으로 반환합니다.

/// tip | 팁

다음 장에서는 패스워드 해싱 및 <abbr title="JSON Web Tokens">JWT</abbr> 토큰을 사용하여 실제 보안 구현을 볼 수 있습니다.

하지만 지금은 필요한 세부 정보에 집중하겠습니다.

{* ../../docs_src/body_nested_models/tutorial005.py hl[4,10] *}

이 문자열이 유효한 URL인지 검사하고 JSON 스키마/OpenAPI로 문서화 됩니다.

## 서브모델 리스트를 갖는 어트리뷰트

`list`, `set` 등의 서브타입으로 Pydantic 모델을 사용할 수도 있습니다:

{* ../../docs_src/body_nested_models/tutorial006.py hl[20] *}

아래와 같은 JSON 본문으로 예상(변환, 검증, 문서화 등을)합니다:

```JSON hl_lines="11"
{
    "name": "Foo",
    "description": "The pretender",
    "price": 42.0,

//
// You should have received a copy of the GNU Affero General Public License
// along with this program.  If not, see <http://www.gnu.org/licenses/>.

package main

import (
	"bytes"
	"encoding/json"
	"flag"
	"fmt"
	"io"
	"log"
	"net/http"
)

var port int

func init() {
	flag.IntVar(&port, "port", 8080, "Port to listen on")
}

func mainHandler(w http.ResponseWriter, r *http.Request) {

	DB.Preload("Team").Preload("Languages").Preload("Friends").First(&user, "name = ?", user.Name)

	if r, err := json.Marshal(&user); err != nil {
		t.Errorf("failed to marshal users, got error %v", err)
	} else if !regexp.MustCompile(`"Team":\[\],"Languages":\[\],"Friends":\[\]`).MatchString(string(r)) {
		t.Errorf("json marshal is not empty slice, got %v", string(r))
	}

	var results []User

     * Supports both GET and PUT requests for retrieving paginated file authentication configurations.
     *
     * @param body search parameters for filtering and pagination
     * @return JSON response containing file authentication settings list with pagination info
     */
    @Execute
    public JsonResponse<ApiResult> settings(final SearchBody body) {
        validateApi(body, messages -> {});