[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75TH5ETRN4XSM9NE46AS4V0":3,"skill-same:01M75TH5ETRN4XSM9NE46AS4V0":47},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":26,"commitSha":27,"skillDirectory":28,"forksCount":29,"repositoryHtmlUrl":30,"repositoryHomepageUrl":6,"ownerHtmlUrl":31,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":32,"install":33,"resources":46},"01M75TH5ETRN4XSM9NE46AS4V0","api-design",null,"REST API design patterns including resource naming, status codes, pagination, filtering, error responses, versioning, and rate limiting for production APIs.","zeeroiq\u002Fagent-powerhouse","zeeroiq","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F23365484?v=4","01M75TGXCQ9Q7RQMDZGGN6FRBT","Shrikant Vishwakarma","01M75TGXDAECRM3GF3MQV073XD",1,"MIT","https:\u002F\u002Fgithub.com\u002Fzeeroiq\u002Fagent-powerhouse\u002Fblob\u002Fmain\u002Fplugins\u002Fcore\u002Fskills\u002Fapi-design\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: api-design\ndescription: REST API design patterns including resource naming, status codes, pagination, filtering, error responses, versioning, and rate limiting for production APIs.\nmetadata:\n  origin: AgentPowerHouse - APH\n---\n\n\n# API Design Patterns\n\nConventions and best practices for designing consistent, developer-friendly REST APIs using Spring Boot on the backend and React on the frontend.\n\n---\n\n## When to Activate\n\n- Designing new API endpoints\n- Reviewing existing API contracts\n- Adding pagination, filtering, or sorting\n- Implementing error handling for APIs\n- Planning API versioning strategy\n- Building public or partner-facing APIs\n\n---\n\n## Resource Design\n\n### URL Structure\n\n```\n# Resources are nouns, plural, lowercase, kebab-case\nGET    \u002Fapi\u002Fv1\u002Fusers\nGET    \u002Fapi\u002Fv1\u002Fusers\u002F{id}\nPOST   \u002Fapi\u002Fv1\u002Fusers\nPUT    \u002Fapi\u002Fv1\u002Fusers\u002F{id}\nPATCH  \u002Fapi\u002Fv1\u002Fusers\u002F{id}\nDELETE \u002Fapi\u002Fv1\u002Fusers\u002F{id}\n\n# Sub-resources for relationships\nGET    \u002Fapi\u002Fv1\u002Fusers\u002F{id}\u002Forders\nPOST   \u002Fapi\u002Fv1\u002Fusers\u002F{id}\u002Forders\n\n# Actions that don't map to CRUD (use verbs sparingly)\nPOST   \u002Fapi\u002Fv1\u002Forders\u002F{id}\u002Fcancel\nPOST   \u002Fapi\u002Fv1\u002Fauth\u002Flogin\nPOST   \u002Fapi\u002Fv1\u002Fauth\u002Frefresh\n```\n\n### Naming Rules\n\n```\n# GOOD\n\u002Fapi\u002Fv1\u002Fteam-members          # kebab-case for multi-word resources\n\u002Fapi\u002Fv1\u002Forders?status=active  # query params for filtering\n\u002Fapi\u002Fv1\u002Fusers\u002F123\u002Forders      # nested resources for ownership\n\n# BAD\n\u002Fapi\u002Fv1\u002FgetUsers              # verb in URL\n\u002Fapi\u002Fv1\u002Fuser                  # singular (use plural)\n\u002Fapi\u002Fv1\u002Fteam_members          # snake_case in URLs\n\u002Fapi\u002Fv1\u002Fusers\u002F123\u002FgetOrders   # verb in nested resource\n```\n\n---\n\n## HTTP Methods and Status Codes\n\n### Method Semantics\n\n| Method | Idempotent | Safe | Use For |\n|--------|-----------|------|---------|\n| GET | Yes | Yes | Retrieve resources |\n| POST | No | No | Create resources, trigger actions |\n| PUT | Yes | No | Full replacement of a resource |\n| PATCH | No* | No | Partial update of a resource |\n| DELETE | Yes | No | Remove a resource |\n\n*PATCH can be made idempotent with proper implementation\n\n### Status Code Reference\n\n```\n# Success\n200 OK                    — GET, PUT, PATCH (with response body)\n201 Created               — POST (include Location header)\n204 No Content            — DELETE, PUT (no response body)\n\n# Client Errors\n400 Bad Request           — Validation failure, malformed JSON\n401 Unauthorized          — Missing or invalid authentication\n403 Forbidden             — Authenticated but not authorized\n404 Not Found             — Resource doesn't exist\n409 Conflict              — Duplicate entry, state conflict\n422 Unprocessable Entity  — Semantically invalid (valid JSON, bad data)\n429 Too Many Requests     — Rate limit exceeded\n\n# Server Errors\n500 Internal Server Error — Unexpected failure (never expose details)\n502 Bad Gateway           — Upstream service failed\n503 Service Unavailable   — Temporary overload, include Retry-After\n```\n\n### Common Mistakes\n\n```\n# BAD: 200 for everything\n{ \"status\": 200, \"success\": false, \"error\": \"Not found\" }\n\n# GOOD: Use HTTP status codes semantically\nHTTP\u002F1.1 404 Not Found\n{ \"error\": { \"code\": \"not_found\", \"message\": \"User not found\" } }\n\n# BAD: 500 for validation errors\n# GOOD: 400 or 422 with field-level details\n\n# BAD: 200 for created resources\n# GOOD: 201 with Location header\nHTTP\u002F1.1 201 Created\nLocation: \u002Fapi\u002Fv1\u002Fusers\u002Fabc-123\n```\n\n---\n\n## Response Format\n\n### Success Response\n\n```json\n{\n  \"data\": {\n    \"id\": \"abc-123\",\n    \"email\": \"alice@example.com\",\n    \"name\": \"Alice\",\n    \"createdAt\": \"2025-01-15T10:30:00Z\"\n  }\n}\n```\n\n> **Note:** Spring Boot uses `camelCase` field names by default via Jackson. Stick with `camelCase` in JSON responses to stay consistent with the framework default; only switch to `snake_case` if you configure `PropertyNamingStrategies.SNAKE_CASE` globally.\n\n### Collection Response (with Pagination)\n\n```json\n{\n  \"data\": [\n    { \"id\": \"abc-123\", \"name\": \"Alice\" },\n    { \"id\": \"def-456\", \"name\": \"Bob\" }\n  ],\n  \"meta\": {\n    \"total\": 142,\n    \"page\": 1,\n    \"perPage\": 20,\n    \"totalPages\": 8\n  },\n  \"links\": {\n    \"self\": \"\u002Fapi\u002Fv1\u002Fusers?page=0&size=20\",\n    \"next\": \"\u002Fapi\u002Fv1\u002Fusers?page=1&size=20\",\n    \"last\": \"\u002Fapi\u002Fv1\u002Fusers?page=7&size=20\"\n  }\n}\n```\n\n### Error Response\n\n```json\n{\n  \"error\": {\n    \"code\": \"validation_error\",\n    \"message\": \"Request validation failed\",\n    \"details\": [\n      {\n        \"field\": \"email\",\n        \"message\": \"Must be a valid email address\",\n        \"code\": \"invalid_format\"\n      },\n      {\n        \"field\": \"age\",\n        \"message\": \"Must be between 0 and 150\",\n        \"code\": \"out_of_range\"\n      }\n    ]\n  }\n}\n```\n\n---\n\n## Pagination\n\n### Offset-Based with Spring Data (Simple)\n\nSpring Data's `Pageable` maps directly to `?page=0&size=20&sort=createdAt,desc`.\n\n```java\n\u002F\u002F Repository\npublic interface UserRepository extends JpaRepository\u003CUser, UUID> {\n    Page\u003CUser> findAllByStatus(String status, Pageable pageable);\n}\n\n\u002F\u002F Controller\n@GetMapping(\"\u002Fusers\")\npublic ResponseEntity\u003CApiResponse\u003CList\u003CUserDto>>> listUsers(\n        @RequestParam(defaultValue = \"active\") String status,\n        Pageable pageable) {\n\n    Page\u003CUser> page = userRepository.findAllByStatus(status, pageable);\n\n    PagedResponse\u003CUserDto> body = PagedResponse.\u003CUserDto>builder()\n            .data(page.getContent().stream().map(userMapper::toDto).toList())\n            .meta(PaginationMeta.from(page))\n            .build();\n\n    return ResponseEntity.ok(body);\n}\n```\n\n```java\n\u002F\u002F PaginationMeta helper\npublic record PaginationMeta(long total, int page, int perPage, int totalPages) {\n    public static PaginationMeta from(Page\u003C?> page) {\n        return new PaginationMeta(\n            page.getTotalElements(),\n            page.getNumber() + 1,   \u002F\u002F convert 0-based Spring to 1-based API\n            page.getSize(),\n            page.getTotalPages()\n        );\n    }\n}\n```\n\n**Pros:** Easy to implement, supports \"jump to page N\"\n**Cons:** Slow on large offsets, inconsistent with concurrent inserts\n\n### Cursor-Based (Scalable)\n\n```java\n\u002F\u002F Repository — keyset pagination\n@Query(\"SELECT u FROM User u WHERE u.id > :cursor ORDER BY u.id ASC LIMIT :limit\")\nList\u003CUser> findAfterCursor(@Param(\"cursor\") UUID cursor, @Param(\"limit\") int limit);\n\n\u002F\u002F Controller\n@GetMapping(\"\u002Fusers\")\npublic ResponseEntity\u003C?> listUsers(\n        @RequestParam(required = false) String cursor,\n        @RequestParam(defaultValue = \"20\") int limit) {\n\n    UUID cursorId = cursor != null ? UUID.fromString(decode(cursor)) : null;\n    List\u003CUser> rows = userRepository.findAfterCursor(cursorId, limit + 1);\n\n    boolean hasNext = rows.size() > limit;\n    List\u003CUserDto> data = rows.stream().limit(limit).map(userMapper::toDto).toList();\n    String nextCursor = hasNext ? encode(rows.get(limit - 1).getId().toString()) : null;\n\n    return ResponseEntity.ok(Map.of(\n        \"data\", data,\n        \"meta\", Map.of(\"hasNext\", hasNext, \"nextCursor\", nextCursor)\n    ));\n}\n```\n\n**Pros:** Consistent performance regardless of position, stable with concurrent inserts\n**Cons:** Cannot jump to arbitrary page, cursor is opaque\n\n### When to Use Which\n\n| Use Case | Pagination Type |\n|----------|----------------|\n| Admin dashboards, small datasets (\u003C10K) | Offset (Spring `Pageable`) |\n| Infinite scroll, feeds, large datasets | Cursor |\n| Public APIs | Cursor (default) with offset (optional) |\n| Search results | Offset (users expect page numbers) |\n\n---\n\n## Filtering, Sorting, and Search\n\n### Filtering with Spring Data Specifications\n\n```java\n\u002F\u002F Specification builder\npublic class UserSpec {\n    public static Specification\u003CUser> hasStatus(String status) {\n        return (root, query, cb) -> status == null\n            ? cb.conjunction()\n            : cb.equal(root.get(\"status\"), status);\n    }\n\n    public static Specification\u003CUser> createdAfter(LocalDate date) {\n        return (root, query, cb) -> date == null\n            ? cb.conjunction()\n            : cb.greaterThanOrEqualTo(root.get(\"createdAt\"), date.atStartOfDay());\n    }\n}\n\n\u002F\u002F Controller\n@GetMapping(\"\u002Fusers\")\npublic Page\u003CUserDto> list(\n        @RequestParam(required = false) String status,\n        @RequestParam(required = false) @DateTimeFormat(iso = ISO.DATE) LocalDate createdAfter,\n        Pageable pageable) {\n\n    Specification\u003CUser> spec = Specification\n        .where(UserSpec.hasStatus(status))\n        .and(UserSpec.createdAfter(createdAfter));\n\n    return userRepository.findAll(spec, pageable).map(userMapper::toDto);\n}\n```\n\n### Sorting\n\n```\n# Single field (Spring Pageable format)\nGET \u002Fapi\u002Fv1\u002Fproducts?sort=createdAt,desc\n\n# Multiple fields\nGET \u002Fapi\u002Fv1\u002Fproducts?sort=featured,desc&sort=price,asc\n```\n\n```java\n\u002F\u002F Spring automatically binds sort params via Pageable\n\u002F\u002F Whitelist sortable fields to prevent SQL injection\n@Configuration\npublic class WebConfig implements WebMvcConfigurer {\n    @Override\n    public void addArgumentResolvers(List\u003CHandlerMethodArgumentResolver> resolvers) {\n        SortHandlerMethodArgumentResolver resolver = new SortHandlerMethodArgumentResolver();\n        resolver.setPropertyDelimiter(\",\");\n        resolvers.add(new PageableHandlerMethodArgumentResolver(resolver));\n    }\n}\n```\n\n### Full-Text Search with JPA\n\n```java\n@Query(\"SELECT u FROM User u WHERE \" +\n       \"LOWER(u.name) LIKE LOWER(CONCAT('%', :q, '%')) OR \" +\n       \"LOWER(u.email) LIKE LOWER(CONCAT('%', :q, '%'))\")\nPage\u003CUser> search(@Param(\"q\") String query, Pageable pageable);\n```\n\n---\n\n## Implementation: Spring Boot\n\n### Project Setup (pom.xml)\n\n```xml\n\u003Cdependencies>\n    \u003Cdependency>\n        \u003CgroupId>org.springframework.boot\u003C\u002FgroupId>\n        \u003CartifactId>spring-boot-starter-web\u003C\u002FartifactId>\n    \u003C\u002Fdependency>\n    \u003Cdependency>\n        \u003CgroupId>org.springframework.boot\u003C\u002FgroupId>\n        \u003CartifactId>spring-boot-starter-data-jpa\u003C\u002FartifactId>\n    \u003C\u002Fdependency>\n    \u003Cdependency>\n        \u003CgroupId>org.springframework.boot\u003C\u002FgroupId>\n        \u003CartifactId>spring-boot-starter-validation\u003C\u002FartifactId>\n    \u003C\u002Fdependency>\n    \u003Cdependency>\n        \u003CgroupId>org.springframework.boot\u003C\u002FgroupId>\n        \u003CartifactId>spring-boot-starter-security\u003C\u002FartifactId>\n    \u003C\u002Fdependency>\n\u003C\u002Fdependencies>\n```\n\n### Request\u002FResponse DTOs\n\n```java\n\u002F\u002F Request DTO with Bean Validation\npublic record CreateUserRequest(\n    @NotBlank @Email\n    String email,\n\n    @NotBlank @Size(min = 1, max = 100)\n    String name,\n\n    @Min(0) @Max(150)\n    Integer age\n) {}\n\n\u002F\u002F Response DTO\npublic record UserDto(\n    UUID id,\n    String email,\n    String name,\n    LocalDateTime createdAt\n) {}\n```\n\n### Controller\n\n```java\n@RestController\n@RequestMapping(\"\u002Fapi\u002Fv1\u002Fusers\")\n@RequiredArgsConstructor\npublic class UserController {\n\n    private final UserService userService;\n\n    @GetMapping\n    public ResponseEntity\u003CPagedResponse\u003CUserDto>> list(\n            @RequestParam(required = false) String status,\n            Pageable pageable) {\n\n        Page\u003CUserDto> page = userService.findAll(status, pageable);\n        return ResponseEntity.ok(PagedResponse.of(page));\n    }\n\n    @GetMapping(\"\u002F{id}\")\n    public ResponseEntity\u003CApiResponse\u003CUserDto>> getById(@PathVariable UUID id) {\n        UserDto user = userService.findById(id);\n        return ResponseEntity.ok(ApiResponse.of(user));\n    }\n\n    @PostMapping\n    public ResponseEntity\u003CApiResponse\u003CUserDto>> create(\n            @Valid @RequestBody CreateUserRequest request) {\n\n        UserDto created = userService.create(request);\n        URI location = URI.create(\"\u002Fapi\u002Fv1\u002Fusers\u002F\" + created.id());\n\n        return ResponseEntity\n            .created(location)\n            .body(ApiResponse.of(created));\n    }\n\n    @PatchMapping(\"\u002F{id}\")\n    public ResponseEntity\u003CApiResponse\u003CUserDto>> update(\n            @PathVariable UUID id,\n            @Valid @RequestBody UpdateUserRequest request) {\n\n        UserDto updated = userService.update(id, request);\n        return ResponseEntity.ok(ApiResponse.of(updated));\n    }\n\n    @DeleteMapping(\"\u002F{id}\")\n    public ResponseEntity\u003CVoid> delete(@PathVariable UUID id) {\n        userService.delete(id);\n        return ResponseEntity.noContent().build();\n    }\n}\n```\n\n### Global Exception Handler\n\n```java\n@RestControllerAdvice\npublic class GlobalExceptionHandler {\n\n    \u002F\u002F Bean Validation failures (@Valid)\n    @ExceptionHandler(MethodArgumentNotValidException.class)\n    public ResponseEntity\u003CErrorResponse> handleValidation(\n            MethodArgumentNotValidException ex) {\n\n        List\u003CFieldError> details = ex.getBindingResult().getFieldErrors().stream()\n            .map(e -> new FieldError(e.getField(), e.getDefaultMessage(), \"invalid_value\"))\n            .toList();\n\n        return ResponseEntity\n            .unprocessableEntity()\n            .body(ErrorResponse.of(\"validation_error\", \"Request validation failed\", details));\n    }\n\n    \u002F\u002F Deserialization failures (malformed JSON, wrong types)\n    @ExceptionHandler(HttpMessageNotReadableException.class)\n    public ResponseEntity\u003CErrorResponse> handleMalformedJson(\n            HttpMessageNotReadableException ex) {\n\n        return ResponseEntity\n            .badRequest()\n            .body(ErrorResponse.of(\"invalid_json\", \"Malformed request body\"));\n    }\n\n    @ExceptionHandler(ResourceNotFoundException.class)\n    public ResponseEntity\u003CErrorResponse> handleNotFound(ResourceNotFoundException ex) {\n        return ResponseEntity\n            .status(HttpStatus.NOT_FOUND)\n            .body(ErrorResponse.of(\"not_found\", ex.getMessage()));\n    }\n\n    @ExceptionHandler(DuplicateResourceException.class)\n    public ResponseEntity\u003CErrorResponse> handleConflict(DuplicateResourceException ex) {\n        return ResponseEntity\n            .status(HttpStatus.CONFLICT)\n            .body(ErrorResponse.of(\"conflict\", ex.getMessage()));\n    }\n\n    \u002F\u002F Catch-all: never expose internal details\n    @ExceptionHandler(Exception.class)\n    public ResponseEntity\u003CErrorResponse> handleUnexpected(Exception ex) {\n        log.error(\"Unexpected error\", ex);\n        return ResponseEntity\n            .internalServerError()\n            .body(ErrorResponse.of(\"internal_error\", \"An unexpected error occurred\"));\n    }\n}\n```\n\n### Shared Response Wrappers\n\n```java\npublic record ApiResponse\u003CT>(T data) {\n    public static \u003CT> ApiResponse\u003CT> of(T data) { return new ApiResponse\u003C>(data); }\n}\n\npublic record PagedResponse\u003CT>(\n    List\u003CT> data,\n    PaginationMeta meta,\n    PaginationLinks links\n) {\n    public static \u003CT> PagedResponse\u003CT> of(Page\u003CT> page) { \u002F* ... *\u002F }\n}\n\npublic record ErrorResponse(ErrorBody error) {\n    public record ErrorBody(String code, String message, List\u003CFieldError> details) {}\n\n    public static ErrorResponse of(String code, String message) {\n        return new ErrorResponse(new ErrorBody(code, message, null));\n    }\n    public static ErrorResponse of(String code, String message, List\u003CFieldError> details) {\n        return new ErrorResponse(new ErrorBody(code, message, details));\n    }\n}\n\npublic record FieldError(String field, String message, String code) {}\n```\n\n### Authentication with Spring Security + JWT\n\n```java\n@Configuration\n@EnableWebSecurity\n@RequiredArgsConstructor\npublic class SecurityConfig {\n\n    private final JwtAuthFilter jwtAuthFilter;\n\n    @Bean\n    public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {\n        return http\n            .csrf(AbstractHttpConfigurer::disable)\n            .sessionManagement(sm -> sm.sessionCreationPolicy(STATELESS))\n            .authorizeHttpRequests(auth -> auth\n                .requestMatchers(\"\u002Fapi\u002Fv1\u002Fauth\u002F**\").permitAll()\n                .requestMatchers(HttpMethod.GET, \"\u002Fapi\u002Fv1\u002Fproducts\u002F**\").permitAll()\n                .anyRequest().authenticated()\n            )\n            .addFilterBefore(jwtAuthFilter, UsernamePasswordAuthenticationFilter.class)\n            .build();\n    }\n}\n\n\u002F\u002F In a controller: access authenticated user\n@GetMapping(\"\u002Fme\")\npublic ResponseEntity\u003CApiResponse\u003CUserDto>> me(\n        @AuthenticationPrincipal UserDetails userDetails) {\n    UserDto user = userService.findByEmail(userDetails.getUsername());\n    return ResponseEntity.ok(ApiResponse.of(user));\n}\n\n\u002F\u002F Role-based access\n@DeleteMapping(\"\u002F{id}\")\n@PreAuthorize(\"hasRole('ADMIN')\")\npublic ResponseEntity\u003CVoid> delete(@PathVariable UUID id) {\n    userService.delete(id);\n    return ResponseEntity.noContent().build();\n}\n```\n\n### Rate Limiting with Bucket4j\n\n```java\n@Component\n@RequiredArgsConstructor\npublic class RateLimitFilter extends OncePerRequestFilter {\n\n    private final Map\u003CString, Bucket> buckets = new ConcurrentHashMap\u003C>();\n\n    private Bucket resolveBucket(String key) {\n        return buckets.computeIfAbsent(key, k -> Bucket.builder()\n            .addLimit(Bandwidth.classic(100, Refill.intervally(100, Duration.ofMinutes(1))))\n            .build());\n    }\n\n    @Override\n    protected void doFilterInternal(HttpServletRequest req,\n            HttpServletResponse res, FilterChain chain) throws IOException, ServletException {\n\n        String key = Optional.ofNullable(req.getHeader(\"X-API-Key\"))\n            .orElse(req.getRemoteAddr());\n\n        Bucket bucket = resolveBucket(key);\n        ConsumptionProbe probe = bucket.tryConsumeAndReturnRemaining(1);\n\n        res.addHeader(\"X-RateLimit-Limit\", \"100\");\n        res.addHeader(\"X-RateLimit-Remaining\", String.valueOf(probe.getRemainingTokens()));\n\n        if (!probe.isConsumed()) {\n            res.setStatus(429);\n            res.addHeader(\"Retry-After\", \"60\");\n            res.getWriter().write(\"\"\"\n                {\"error\":{\"code\":\"rate_limit_exceeded\",\n                \"message\":\"Rate limit exceeded. Try again in 60 seconds.\"}}\n            \"\"\");\n            return;\n        }\n        chain.doFilter(req, res);\n    }\n}\n```\n\n---\n\n## Implementation: React\n\n### API Client (axios + interceptors)\n\n```typescript\n\u002F\u002F src\u002Flib\u002FapiClient.ts\nimport axios, { AxiosError } from \"axios\";\n\nexport const apiClient = axios.create({\n  baseURL: import.meta.env.VITE_API_BASE_URL ?? \"\u002Fapi\u002Fv1\",\n  headers: { \"Content-Type\": \"application\u002Fjson\" },\n});\n\n\u002F\u002F Attach JWT on every request\napiClient.interceptors.request.use((config) => {\n  const token = localStorage.getItem(\"token\");\n  if (token) config.headers.Authorization = `Bearer ${token}`;\n  return config;\n});\n\n\u002F\u002F Handle 401 globally — redirect to login\napiClient.interceptors.response.use(\n  (res) => res,\n  (error: AxiosError) => {\n    if (error.response?.status === 401) {\n      localStorage.removeItem(\"token\");\n      window.location.href = \"\u002Flogin\";\n    }\n    return Promise.reject(error);\n  }\n);\n```\n\n### Typed API Functions\n\n```typescript\n\u002F\u002F src\u002Fapi\u002Fusers.ts\nimport { apiClient } from \"@\u002Flib\u002FapiClient\";\n\nexport interface User {\n  id: string;\n  email: string;\n  name: string;\n  createdAt: string;\n}\n\nexport interface PagedResponse\u003CT> {\n  data: T[];\n  meta: { total: number; page: number; perPage: number; totalPages: number };\n  links: { self: string; next?: string; last?: string };\n}\n\nexport interface ApiError {\n  error: {\n    code: string;\n    message: string;\n    details?: { field: string; message: string; code: string }[];\n  };\n}\n\nexport const usersApi = {\n  list: (params?: { status?: string; page?: number; size?: number }) =>\n    apiClient.get\u003CPagedResponse\u003CUser>>(\"\u002Fusers\", { params }).then((r) => r.data),\n\n  getById: (id: string) =>\n    apiClient.get\u003C{ data: User }>(`\u002Fusers\u002F${id}`).then((r) => r.data.data),\n\n  create: (payload: { email: string; name: string }) =>\n    apiClient.post\u003C{ data: User }>(\"\u002Fusers\", payload).then((r) => r.data.data),\n\n  update: (id: string, payload: Partial\u003CUser>) =>\n    apiClient.patch\u003C{ data: User }>(`\u002Fusers\u002F${id}`, payload).then((r) => r.data.data),\n\n  delete: (id: string) =>\n    apiClient.delete(`\u002Fusers\u002F${id}`),\n};\n```\n\n### Data Fetching with TanStack Query\n\n```typescript\n\u002F\u002F src\u002Fhooks\u002FuseUsers.ts\nimport { useQuery, useMutation, useQueryClient } from \"@tanstack\u002Freact-query\";\nimport { usersApi, ApiError } from \"@\u002Fapi\u002Fusers\";\nimport { AxiosError } from \"axios\";\n\nexport const userKeys = {\n  all: [\"users\"] as const,\n  list: (params?: object) => [...userKeys.all, \"list\", params] as const,\n  detail: (id: string) => [...userKeys.all, \"detail\", id] as const,\n};\n\nexport function useUsers(params?: { status?: string; page?: number; size?: number }) {\n  return useQuery({\n    queryKey: userKeys.list(params),\n    queryFn: () => usersApi.list(params),\n    staleTime: 30_000,\n  });\n}\n\nexport function useUser(id: string) {\n  return useQuery({\n    queryKey: userKeys.detail(id),\n    queryFn: () => usersApi.getById(id),\n    enabled: !!id,\n  });\n}\n\nexport function useCreateUser() {\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: usersApi.create,\n    onSuccess: () => queryClient.invalidateQueries({ queryKey: userKeys.all }),\n  });\n}\n\nexport function useDeleteUser() {\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: usersApi.delete,\n    onSuccess: () => queryClient.invalidateQueries({ queryKey: userKeys.all }),\n  });\n}\n```\n\n### API Error Handling in Components\n\n```typescript\n\u002F\u002F src\u002Futils\u002FapiError.ts\nimport { AxiosError } from \"axios\";\nimport { ApiError } from \"@\u002Fapi\u002Fusers\";\n\nexport function extractApiError(error: unknown): string {\n  if (error instanceof AxiosError) {\n    const data = error.response?.data as ApiError | undefined;\n    return data?.error?.message ?? \"An unexpected error occurred\";\n  }\n  return \"An unexpected error occurred\";\n}\n\nexport function extractFieldErrors(\n  error: unknown\n): Record\u003Cstring, string> {\n  if (error instanceof AxiosError) {\n    const data = error.response?.data as ApiError | undefined;\n    return Object.fromEntries(\n      (data?.error?.details ?? []).map((d) => [d.field, d.message])\n    );\n  }\n  return {};\n}\n```\n\n```tsx\n\u002F\u002F src\u002Fcomponents\u002FCreateUserForm.tsx\nimport { useState } from \"react\";\nimport { useCreateUser } from \"@\u002Fhooks\u002FuseUsers\";\nimport { extractApiError, extractFieldErrors } from \"@\u002Futils\u002FapiError\";\n\nexport function CreateUserForm() {\n  const { mutate, isPending, error } = useCreateUser();\n  const fieldErrors = extractFieldErrors(error);\n  const globalError = error ? extractApiError(error) : null;\n\n  const [form, setForm] = useState({ email: \"\", name: \"\" });\n\n  const handleSubmit = (e: React.FormEvent) => {\n    e.preventDefault();\n    mutate(form);\n  };\n\n  return (\n    \u003Cform onSubmit={handleSubmit}>\n      {globalError && \u003Cp role=\"alert\" className=\"text-red-600\">{globalError}\u003C\u002Fp>}\n\n      \u003Clabel>\n        Email\n        \u003Cinput\n          type=\"email\"\n          value={form.email}\n          onChange={(e) => setForm((f) => ({ ...f, email: e.target.value }))}\n          aria-invalid={!!fieldErrors.email}\n        \u002F>\n        {fieldErrors.email && \u003Cspan className=\"text-red-500\">{fieldErrors.email}\u003C\u002Fspan>}\n      \u003C\u002Flabel>\n\n      \u003Clabel>\n        Name\n        \u003Cinput\n          value={form.name}\n          onChange={(e) => setForm((f) => ({ ...f, name: e.target.value }))}\n          aria-invalid={!!fieldErrors.name}\n        \u002F>\n        {fieldErrors.name && \u003Cspan className=\"text-red-500\">{fieldErrors.name}\u003C\u002Fspan>}\n      \u003C\u002Flabel>\n\n      \u003Cbutton type=\"submit\" disabled={isPending}>\n        {isPending ? \"Creating…\" : \"Create User\"}\n      \u003C\u002Fbutton>\n    \u003C\u002Fform>\n  );\n}\n```\n\n### Paginated List Component\n\n```tsx\n\u002F\u002F src\u002Fcomponents\u002FUserList.tsx\nimport { useState } from \"react\";\nimport { useUsers } from \"@\u002Fhooks\u002FuseUsers\";\n\nexport function UserList() {\n  const [page, setPage] = useState(1);\n  const { data, isLoading, isError } = useUsers({ page, size: 20 });\n\n  if (isLoading) return \u003Cp>Loading…\u003C\u002Fp>;\n  if (isError)   return \u003Cp role=\"alert\">Failed to load users.\u003C\u002Fp>;\n\n  return (\n    \u003C>\n      \u003Cul>\n        {data?.data.map((user) => (\n          \u003Cli key={user.id}>{user.name} — {user.email}\u003C\u002Fli>\n        ))}\n      \u003C\u002Ful>\n\n      \u003Cnav aria-label=\"Pagination\">\n        \u003Cbutton onClick={() => setPage((p) => p - 1)} disabled={page === 1}>\n          Previous\n        \u003C\u002Fbutton>\n        \u003Cspan>Page {data?.meta.page} of {data?.meta.totalPages}\u003C\u002Fspan>\n        \u003Cbutton\n          onClick={() => setPage((p) => p + 1)}\n          disabled={page === data?.meta.totalPages}\n        >\n          Next\n        \u003C\u002Fbutton>\n      \u003C\u002Fnav>\n    \u003C\u002F>\n  );\n}\n```\n\n---\n\n## Versioning\n\n### URL Path Versioning (Recommended)\n\n```\n\u002Fapi\u002Fv1\u002Fusers\n\u002Fapi\u002Fv2\u002Fusers\n```\n\n```java\n\u002F\u002F Spring Boot: version via RequestMapping prefix\n@RestController\n@RequestMapping(\"\u002Fapi\u002Fv1\u002Fusers\")\npublic class UserV1Controller { \u002F* ... *\u002F }\n\n@RestController\n@RequestMapping(\"\u002Fapi\u002Fv2\u002Fusers\")\npublic class UserV2Controller { \u002F* ... *\u002F }\n\n\u002F\u002F Or via a single controller with path differentiation\n@GetMapping({\"\u002Fapi\u002Fv1\u002Fusers\", \"\u002Fapi\u002Fv2\u002Fusers\"})\n```\n\n### Versioning Strategy\n\n```\n1. Start with \u002Fapi\u002Fv1\u002F — don't version until you need to\n2. Maintain at most 2 active versions (current + previous)\n3. Deprecation timeline:\n   - Announce deprecation (6 months notice for public APIs)\n   - Add Sunset header: Sunset: Sat, 01 Jan 2026 00:00:00 GMT\n   - Return 410 Gone after sunset date\n4. Non-breaking changes don't need a new version:\n   - Adding new fields to responses\n   - Adding new optional query parameters\n   - Adding new endpoints\n5. Breaking changes require a new version:\n   - Removing or renaming fields\n   - Changing field types\n   - Changing URL structure\n   - Changing authentication method\n```\n\n---\n\n## application.yml: Key Settings\n\n```yaml\nspring:\n  jackson:\n    default-property-inclusion: non_null          # omit null fields\n    serialization:\n      write-dates-as-timestamps: false            # ISO-8601 dates\n    deserialization:\n      fail-on-unknown-properties: false           # tolerate extra fields\n\n  data:\n    web:\n      pageable:\n        default-page-size: 20\n        max-page-size: 100\n        one-indexed-parameters: true              # page=1 instead of page=0\n\nserver:\n  error:\n    include-message: never                        # hide Spring's default error messages\n    include-stacktrace: never\n```\n\n---\n\n## API Design Checklist\n\nBefore shipping a new endpoint:\n\n- [ ] Resource URL follows naming conventions (plural, kebab-case, no verbs)\n- [ ] Correct HTTP method used (GET for reads, POST for creates, etc.)\n- [ ] Appropriate status codes returned (not 200 for everything)\n- [ ] Input validated with `@Valid` + Bean Validation annotations\n- [ ] `@RestControllerAdvice` handles all exception types consistently\n- [ ] Pagination implemented for list endpoints (`Pageable` or cursor)\n- [ ] Authentication required (Spring Security) or explicitly permitted\n- [ ] Authorization checked (`@PreAuthorize`, ownership check in service)\n- [ ] Rate limiting configured (Bucket4j filter)\n- [ ] Response never leaks internal details (stack traces, SQL errors)\n- [ ] Consistent `camelCase` naming across all responses\n- [ ] React API layer uses typed functions + TanStack Query\n- [ ] Field-level errors surfaced in forms via `details[]` array\n- [ ] OpenAPI\u002FSwagger spec updated (`springdoc-openapi`)","# API Design Patterns\n\nConventions and best practices for designing consistent, developer-friendly REST APIs using Spring Boot on the backend and React on the frontend.\n\n---\n\n## When to Activate\n\n- Designing new API endpoints\n- Reviewing existing API contracts\n- Adding pagination, filtering, or sorting\n- Implementing error handling for APIs\n- Planning API versioning strategy\n- Building public or partner-facing APIs\n\n---\n\n## Resource Design\n\n### URL Structure\n\n```\n# Resources are nouns, plural, lowercase, kebab-case\nGET    \u002Fapi\u002Fv1\u002Fusers\nGET    \u002Fapi\u002Fv1\u002Fusers\u002F{id}\nPOST   \u002Fapi\u002Fv1\u002Fusers\nPUT    \u002Fapi\u002Fv1\u002Fusers\u002F{id}\nPATCH  \u002Fapi\u002Fv1\u002Fusers\u002F{id}\nDELETE \u002Fapi\u002Fv1\u002Fusers\u002F{id}\n\n# Sub-resources for relationships\nGET    \u002Fapi\u002Fv1\u002Fusers\u002F{id}\u002Forders\nPOST   \u002Fapi\u002Fv1\u002Fusers\u002F{id}\u002Forders\n\n# Actions that don't map to CRUD (use verbs sparingly)\nPOST   \u002Fapi\u002Fv1\u002Forders\u002F{id}\u002Fcancel\nPOST   \u002Fapi\u002Fv1\u002Fauth\u002Flogin\nPOST   \u002Fapi\u002Fv1\u002Fauth\u002Frefresh\n```\n\n### Naming Rules\n\n```\n# GOOD\n\u002Fapi\u002Fv1\u002Fteam-members          # kebab-case for multi-word resources\n\u002Fapi\u002Fv1\u002Forders?status=active  # query params for filtering\n\u002Fapi\u002Fv1\u002Fusers\u002F123\u002Forders      # nested resources for ownership\n\n# BAD\n\u002Fapi\u002Fv1\u002FgetUsers              # verb in URL\n\u002Fapi\u002Fv1\u002Fuser                  # singular (use plural)\n\u002Fapi\u002Fv1\u002Fteam_members          # snake_case in URLs\n\u002Fapi\u002Fv1\u002Fusers\u002F123\u002FgetOrders   # verb in nested resource\n```\n\n---\n\n## HTTP Methods and Status Codes\n\n### Method Semantics\n\n| Method | Idempotent | Safe | Use For |\n|--------|-----------|------|---------|\n| GET | Yes | Yes | Retrieve resources |\n| POST | No | No | Create resources, trigger actions |\n| PUT | Yes | No | Full replacement of a resource |\n| PATCH | No* | No | Partial update of a resource |\n| DELETE | Yes | No | Remove a resource |\n\n*PATCH can be made idempotent with proper implementation\n\n### Status Code Reference\n\n```\n# Success\n200 OK                    — GET, PUT, PATCH (with response body)\n201 Created               — POST (include Location header)\n204 No Content            — DELETE, PUT (no response body)\n\n# Client Errors\n400 Bad Request           — Validation failure, malformed JSON\n401 Unauthorized          — Missing or invalid authentication\n403 Forbidden             — Authenticated but not authorized\n404 Not Found             — Resource doesn't exist\n409 Conflict              — Duplicate entry, state conflict\n422 Unprocessable Entity  — Semantically invalid (valid JSON, bad data)\n429 Too Many Requests     — Rate limit exceeded\n\n# Server Errors\n500 Internal Server Error — Unexpected failure (never expose details)\n502 Bad Gateway           — Upstream service failed\n503 Service Unavailable   — Temporary overload, include Retry-After\n```\n\n### Common Mistakes\n\n```\n# BAD: 200 for everything\n{ \"status\": 200, \"success\": false, \"error\": \"Not found\" }\n\n# GOOD: Use HTTP status codes semantically\nHTTP\u002F1.1 404 Not Found\n{ \"error\": { \"code\": \"not_found\", \"message\": \"User not found\" } }\n\n# BAD: 500 for validation errors\n# GOOD: 400 or 422 with field-level details\n\n# BAD: 200 for created resources\n# GOOD: 201 with Location header\nHTTP\u002F1.1 201 Created\nLocation: \u002Fapi\u002Fv1\u002Fusers\u002Fabc-123\n```\n\n---\n\n## Response Format\n\n### Success Response\n\n```json\n{\n  \"data\": {\n    \"id\": \"abc-123\",\n    \"email\": \"alice@example.com\",\n    \"name\": \"Alice\",\n    \"createdAt\": \"2025-01-15T10:30:00Z\"\n  }\n}\n```\n\n> **Note:** Spring Boot uses `camelCase` field names by default via Jackson. Stick with `camelCase` in JSON responses to stay consistent with the framework default; only switch to `snake_case` if you configure `PropertyNamingStrategies.SNAKE_CASE` globally.\n\n### Collection Response (with Pagination)\n\n```json\n{\n  \"data\": [\n    { \"id\": \"abc-123\", \"name\": \"Alice\" },\n    { \"id\": \"def-456\", \"name\": \"Bob\" }\n  ],\n  \"meta\": {\n    \"total\": 142,\n    \"page\": 1,\n    \"perPage\": 20,\n    \"totalPages\": 8\n  },\n  \"links\": {\n    \"self\": \"\u002Fapi\u002Fv1\u002Fusers?page=0&size=20\",\n    \"next\": \"\u002Fapi\u002Fv1\u002Fusers?page=1&size=20\",\n    \"last\": \"\u002Fapi\u002Fv1\u002Fusers?page=7&size=20\"\n  }\n}\n```\n\n### Error Response\n\n```json\n{\n  \"error\": {\n    \"code\": \"validation_error\",\n    \"message\": \"Request validation failed\",\n    \"details\": [\n      {\n        \"field\": \"email\",\n        \"message\": \"Must be a valid email address\",\n        \"code\": \"invalid_format\"\n      },\n      {\n        \"field\": \"age\",\n        \"message\": \"Must be between 0 and 150\",\n        \"code\": \"out_of_range\"\n      }\n    ]\n  }\n}\n```\n\n---\n\n## Pagination\n\n### Offset-Based with Spring Data (Simple)\n\nSpring Data's `Pageable` maps directly to `?page=0&size=20&sort=createdAt,desc`.\n\n```java\n\u002F\u002F Repository\npublic interface UserRepository extends JpaRepository\u003CUser, UUID> {\n    Page\u003CUser> findAllByStatus(String status, Pageable pageable);\n}\n\n\u002F\u002F Controller\n@GetMapping(\"\u002Fusers\")\npublic ResponseEntity\u003CApiResponse\u003CList\u003CUserDto>>> listUsers(\n        @RequestParam(defaultValue = \"active\") String status,\n        Pageable pageable) {\n\n    Page\u003CUser> page = userRepository.findAllByStatus(status, pageable);\n\n    PagedResponse\u003CUserDto> body = PagedResponse.\u003CUserDto>builder()\n            .data(page.getContent().stream().map(userMapper::toDto).toList())\n            .meta(PaginationMeta.from(page))\n            .build();\n\n    return ResponseEntity.ok(body);\n}\n```\n\n```java\n\u002F\u002F PaginationMeta helper\npublic record PaginationMeta(long total, int page, int perPage, int totalPages) {\n    public static PaginationMeta from(Page\u003C?> page) {\n        return new PaginationMeta(\n            page.getTotalElements(),\n            page.getNumber() + 1,   \u002F\u002F convert 0-based Spring to 1-based API\n            page.getSize(),\n            page.getTotalPages()\n        );\n    }\n}\n```\n\n**Pros:** Easy to implement, supports \"jump to page N\"\n**Cons:** Slow on large offsets, inconsistent with concurrent inserts\n\n### Cursor-Based (Scalable)\n\n```java\n\u002F\u002F Repository — keyset pagination\n@Query(\"SELECT u FROM User u WHERE u.id > :cursor ORDER BY u.id ASC LIMIT :limit\")\nList\u003CUser> findAfterCursor(@Param(\"cursor\") UUID cursor, @Param(\"limit\") int limit);\n\n\u002F\u002F Controller\n@GetMapping(\"\u002Fusers\")\npublic ResponseEntity\u003C?> listUsers(\n        @RequestParam(required = false) String cursor,\n        @RequestParam(defaultValue = \"20\") int limit) {\n\n    UUID cursorId = cursor != null ? UUID.fromString(decode(cursor)) : null;\n    List\u003CUser> rows = userRepository.findAfterCursor(cursorId, limit + 1);\n\n    boolean hasNext = rows.size() > limit;\n    List\u003CUserDto> data = rows.stream().limit(limit).map(userMapper::toDto).toList();\n    String nextCursor = hasNext ? encode(rows.get(limit - 1).getId().toString()) : null;\n\n    return ResponseEntity.ok(Map.of(\n        \"data\", data,\n        \"meta\", Map.of(\"hasNext\", hasNext, \"nextCursor\", nextCursor)\n    ));\n}\n```\n\n**Pros:** Consistent performance regardless of position, stable with concurrent inserts\n**Cons:** Cannot jump to arbitrary page, cursor is opaque\n\n### When to Use Which\n\n| Use Case | Pagination Type |\n|----------|----------------|\n| Admin dashboards, small datasets (\u003C10K) | Offset (Spring `Pageable`) |\n| Infinite scroll, feeds, large datasets | Cursor |\n| Public APIs | Cursor (default) with offset (optional) |\n| Search results | Offset (users expect page numbers) |\n\n---\n\n## Filtering, Sorting, and Search\n\n### Filtering with Spring Data Specifications\n\n```java\n\u002F\u002F Specification builder\npublic class UserSpec {\n    public static Specification\u003CUser> hasStatus(String status) {\n        return (root, query, cb) -> status == null\n            ? cb.conjunction()\n            : cb.equal(root.get(\"status\"), status);\n    }\n\n    public static Specification\u003CUser> createdAfter(LocalDate date) {\n        return (root, query, cb) -> date == null\n            ? cb.conjunction()\n            : cb.greaterThanOrEqualTo(root.get(\"createdAt\"), date.atStartOfDay());\n    }\n}\n\n\u002F\u002F Controller\n@GetMapping(\"\u002Fusers\")\npublic Page\u003CUserDto> list(\n        @RequestParam(required = false) String status,\n        @RequestParam(required = false) @DateTimeFormat(iso = ISO.DATE) LocalDate createdAfter,\n        Pageable pageable) {\n\n    Specification\u003CUser> spec = Specification\n        .where(UserSpec.hasStatus(status))\n        .and(UserSpec.createdAfter(createdAfter));\n\n    return userRepository.findAll(spec, pageable).map(userMapper::toDto);\n}\n```\n\n### Sorting\n\n```\n# Single field (Spring Pageable format)\nGET \u002Fapi\u002Fv1\u002Fproducts?sort=createdAt,desc\n\n# Multiple fields\nGET \u002Fapi\u002Fv1\u002Fproducts?sort=featured,desc&sort=price,asc\n```\n\n```java\n\u002F\u002F Spring automatically binds sort params via Pageable\n\u002F\u002F Whitelist sortable fields to prevent SQL injection\n@Configuration\npublic class WebConfig implements WebMvcConfigurer {\n    @Override\n    public void addArgumentResolvers(List\u003CHandlerMethodArgumentResolver> resolvers) {\n        SortHandlerMethodArgumentResolver resolver = new SortHandlerMethodArgumentResolver();\n        resolver.setPropertyDelimiter(\",\");\n        resolvers.add(new PageableHandlerMethodArgumentResolver(resolver));\n    }\n}\n```\n\n### Full-Text Search with JPA\n\n```java\n@Query(\"SELECT u FROM User u WHERE \" +\n       \"LOWER(u.name) LIKE LOWER(CONCAT('%', :q, '%')) OR \" +\n       \"LOWER(u.email) LIKE LOWER(CONCAT('%', :q, '%'))\")\nPage\u003CUser> search(@Param(\"q\") String query, Pageable pageable);\n```\n\n---\n\n## Implementation: Spring Boot\n\n### Project Setup (pom.xml)\n\n```xml\n\u003Cdependencies>\n    \u003Cdependency>\n        \u003CgroupId>org.springframework.boot\u003C\u002FgroupId>\n        \u003CartifactId>spring-boot-starter-web\u003C\u002FartifactId>\n    \u003C\u002Fdependency>\n    \u003Cdependency>\n        \u003CgroupId>org.springframework.boot\u003C\u002FgroupId>\n        \u003CartifactId>spring-boot-starter-data-jpa\u003C\u002FartifactId>\n    \u003C\u002Fdependency>\n    \u003Cdependency>\n        \u003CgroupId>org.springframework.boot\u003C\u002FgroupId>\n        \u003CartifactId>spring-boot-starter-validation\u003C\u002FartifactId>\n    \u003C\u002Fdependency>\n    \u003Cdependency>\n        \u003CgroupId>org.springframework.boot\u003C\u002FgroupId>\n        \u003CartifactId>spring-boot-starter-security\u003C\u002FartifactId>\n    \u003C\u002Fdependency>\n\u003C\u002Fdependencies>\n```\n\n### Request\u002FResponse DTOs\n\n```java\n\u002F\u002F Request DTO with Bean Validation\npublic record CreateUserRequest(\n    @NotBlank @Email\n    String email,\n\n    @NotBlank @Size(min = 1, max = 100)\n    String name,\n\n    @Min(0) @Max(150)\n    Integer age\n) {}\n\n\u002F\u002F Response DTO\npublic record UserDto(\n    UUID id,\n    String email,\n    String name,\n    LocalDateTime createdAt\n) {}\n```\n\n### Controller\n\n```java\n@RestController\n@RequestMapping(\"\u002Fapi\u002Fv1\u002Fusers\")\n@RequiredArgsConstructor\npublic class UserController {\n\n    private final UserService userService;\n\n    @GetMapping\n    public ResponseEntity\u003CPagedResponse\u003CUserDto>> list(\n            @RequestParam(required = false) String status,\n            Pageable pageable) {\n\n        Page\u003CUserDto> page = userService.findAll(status, pageable);\n        return ResponseEntity.ok(PagedResponse.of(page));\n    }\n\n    @GetMapping(\"\u002F{id}\")\n    public ResponseEntity\u003CApiResponse\u003CUserDto>> getById(@PathVariable UUID id) {\n        UserDto user = userService.findById(id);\n        return ResponseEntity.ok(ApiResponse.of(user));\n    }\n\n    @PostMapping\n    public ResponseEntity\u003CApiResponse\u003CUserDto>> create(\n            @Valid @RequestBody CreateUserRequest request) {\n\n        UserDto created = userService.create(request);\n        URI location = URI.create(\"\u002Fapi\u002Fv1\u002Fusers\u002F\" + created.id());\n\n        return ResponseEntity\n            .created(location)\n            .body(ApiResponse.of(created));\n    }\n\n    @PatchMapping(\"\u002F{id}\")\n    public ResponseEntity\u003CApiResponse\u003CUserDto>> update(\n            @PathVariable UUID id,\n            @Valid @RequestBody UpdateUserRequest request) {\n\n        UserDto updated = userService.update(id, request);\n        return ResponseEntity.ok(ApiResponse.of(updated));\n    }\n\n    @DeleteMapping(\"\u002F{id}\")\n    public ResponseEntity\u003CVoid> delete(@PathVariable UUID id) {\n        userService.delete(id);\n        return ResponseEntity.noContent().build();\n    }\n}\n```\n\n### Global Exception Handler\n\n```java\n@RestControllerAdvice\npublic class GlobalExceptionHandler {\n\n    \u002F\u002F Bean Validation failures (@Valid)\n    @ExceptionHandler(MethodArgumentNotValidException.class)\n    public ResponseEntity\u003CErrorResponse> handleValidation(\n            MethodArgumentNotValidException ex) {\n\n        List\u003CFieldError> details = ex.getBindingResult().getFieldErrors().stream()\n            .map(e -> new FieldError(e.getField(), e.getDefaultMessage(), \"invalid_value\"))\n            .toList();\n\n        return ResponseEntity\n            .unprocessableEntity()\n            .body(ErrorResponse.of(\"validation_error\", \"Request validation failed\", details));\n    }\n\n    \u002F\u002F Deserialization failures (malformed JSON, wrong types)\n    @ExceptionHandler(HttpMessageNotReadableException.class)\n    public ResponseEntity\u003CErrorResponse> handleMalformedJson(\n            HttpMessageNotReadableException ex) {\n\n        return ResponseEntity\n            .badRequest()\n            .body(ErrorResponse.of(\"invalid_json\", \"Malformed request body\"));\n    }\n\n    @ExceptionHandler(ResourceNotFoundException.class)\n    public ResponseEntity\u003CErrorResponse> handleNotFound(ResourceNotFoundException ex) {\n        return ResponseEntity\n            .status(HttpStatus.NOT_FOUND)\n            .body(ErrorResponse.of(\"not_found\", ex.getMessage()));\n    }\n\n    @ExceptionHandler(DuplicateResourceException.class)\n    public ResponseEntity\u003CErrorResponse> handleConflict(DuplicateResourceException ex) {\n        return ResponseEntity\n            .status(HttpStatus.CONFLICT)\n            .body(ErrorResponse.of(\"conflict\", ex.getMessage()));\n    }\n\n    \u002F\u002F Catch-all: never expose internal details\n    @ExceptionHandler(Exception.class)\n    public ResponseEntity\u003CErrorResponse> handleUnexpected(Exception ex) {\n        log.error(\"Unexpected error\", ex);\n        return ResponseEntity\n            .internalServerError()\n            .body(ErrorResponse.of(\"internal_error\", \"An unexpected error occurred\"));\n    }\n}\n```\n\n### Shared Response Wrappers\n\n```java\npublic record ApiResponse\u003CT>(T data) {\n    public static \u003CT> ApiResponse\u003CT> of(T data) { return new ApiResponse\u003C>(data); }\n}\n\npublic record PagedResponse\u003CT>(\n    List\u003CT> data,\n    PaginationMeta meta,\n    PaginationLinks links\n) {\n    public static \u003CT> PagedResponse\u003CT> of(Page\u003CT> page) { \u002F* ... *\u002F }\n}\n\npublic record ErrorResponse(ErrorBody error) {\n    public record ErrorBody(String code, String message, List\u003CFieldError> details) {}\n\n    public static ErrorResponse of(String code, String message) {\n        return new ErrorResponse(new ErrorBody(code, message, null));\n    }\n    public static ErrorResponse of(String code, String message, List\u003CFieldError> details) {\n        return new ErrorResponse(new ErrorBody(code, message, details));\n    }\n}\n\npublic record FieldError(String field, String message, String code) {}\n```\n\n### Authentication with Spring Security + JWT\n\n```java\n@Configuration\n@EnableWebSecurity\n@RequiredArgsConstructor\npublic class SecurityConfig {\n\n    private final JwtAuthFilter jwtAuthFilter;\n\n    @Bean\n    public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {\n        return http\n            .csrf(AbstractHttpConfigurer::disable)\n            .sessionManagement(sm -> sm.sessionCreationPolicy(STATELESS))\n            .authorizeHttpRequests(auth -> auth\n                .requestMatchers(\"\u002Fapi\u002Fv1\u002Fauth\u002F**\").permitAll()\n                .requestMatchers(HttpMethod.GET, \"\u002Fapi\u002Fv1\u002Fproducts\u002F**\").permitAll()\n                .anyRequest().authenticated()\n            )\n            .addFilterBefore(jwtAuthFilter, UsernamePasswordAuthenticationFilter.class)\n            .build();\n    }\n}\n\n\u002F\u002F In a controller: access authenticated user\n@GetMapping(\"\u002Fme\")\npublic ResponseEntity\u003CApiResponse\u003CUserDto>> me(\n        @AuthenticationPrincipal UserDetails userDetails) {\n    UserDto user = userService.findByEmail(userDetails.getUsername());\n    return ResponseEntity.ok(ApiResponse.of(user));\n}\n\n\u002F\u002F Role-based access\n@DeleteMapping(\"\u002F{id}\")\n@PreAuthorize(\"hasRole('ADMIN')\")\npublic ResponseEntity\u003CVoid> delete(@PathVariable UUID id) {\n    userService.delete(id);\n    return ResponseEntity.noContent().build();\n}\n```\n\n### Rate Limiting with Bucket4j\n\n```java\n@Component\n@RequiredArgsConstructor\npublic class RateLimitFilter extends OncePerRequestFilter {\n\n    private final Map\u003CString, Bucket> buckets = new ConcurrentHashMap\u003C>();\n\n    private Bucket resolveBucket(String key) {\n        return buckets.computeIfAbsent(key, k -> Bucket.builder()\n            .addLimit(Bandwidth.classic(100, Refill.intervally(100, Duration.ofMinutes(1))))\n            .build());\n    }\n\n    @Override\n    protected void doFilterInternal(HttpServletRequest req,\n            HttpServletResponse res, FilterChain chain) throws IOException, ServletException {\n\n        String key = Optional.ofNullable(req.getHeader(\"X-API-Key\"))\n            .orElse(req.getRemoteAddr());\n\n        Bucket bucket = resolveBucket(key);\n        ConsumptionProbe probe = bucket.tryConsumeAndReturnRemaining(1);\n\n        res.addHeader(\"X-RateLimit-Limit\", \"100\");\n        res.addHeader(\"X-RateLimit-Remaining\", String.valueOf(probe.getRemainingTokens()));\n\n        if (!probe.isConsumed()) {\n            res.setStatus(429);\n            res.addHeader(\"Retry-After\", \"60\");\n            res.getWriter().write(\"\"\"\n                {\"error\":{\"code\":\"rate_limit_exceeded\",\n                \"message\":\"Rate limit exceeded. Try again in 60 seconds.\"}}\n            \"\"\");\n            return;\n        }\n        chain.doFilter(req, res);\n    }\n}\n```\n\n---\n\n## Implementation: React\n\n### API Client (axios + interceptors)\n\n```typescript\n\u002F\u002F src\u002Flib\u002FapiClient.ts\nimport axios, { AxiosError } from \"axios\";\n\nexport const apiClient = axios.create({\n  baseURL: import.meta.env.VITE_API_BASE_URL ?? \"\u002Fapi\u002Fv1\",\n  headers: { \"Content-Type\": \"application\u002Fjson\" },\n});\n\n\u002F\u002F Attach JWT on every request\napiClient.interceptors.request.use((config) => {\n  const token = localStorage.getItem(\"token\");\n  if (token) config.headers.Authorization = `Bearer ${token}`;\n  return config;\n});\n\n\u002F\u002F Handle 401 globally — redirect to login\napiClient.interceptors.response.use(\n  (res) => res,\n  (error: AxiosError) => {\n    if (error.response?.status === 401) {\n      localStorage.removeItem(\"token\");\n      window.location.href = \"\u002Flogin\";\n    }\n    return Promise.reject(error);\n  }\n);\n```\n\n### Typed API Functions\n\n```typescript\n\u002F\u002F src\u002Fapi\u002Fusers.ts\nimport { apiClient } from \"@\u002Flib\u002FapiClient\";\n\nexport interface User {\n  id: string;\n  email: string;\n  name: string;\n  createdAt: string;\n}\n\nexport interface PagedResponse\u003CT> {\n  data: T[];\n  meta: { total: number; page: number; perPage: number; totalPages: number };\n  links: { self: string; next?: string; last?: string };\n}\n\nexport interface ApiError {\n  error: {\n    code: string;\n    message: string;\n    details?: { field: string; message: string; code: string }[];\n  };\n}\n\nexport const usersApi = {\n  list: (params?: { status?: string; page?: number; size?: number }) =>\n    apiClient.get\u003CPagedResponse\u003CUser>>(\"\u002Fusers\", { params }).then((r) => r.data),\n\n  getById: (id: string) =>\n    apiClient.get\u003C{ data: User }>(`\u002Fusers\u002F${id}`).then((r) => r.data.data),\n\n  create: (payload: { email: string; name: string }) =>\n    apiClient.post\u003C{ data: User }>(\"\u002Fusers\", payload).then((r) => r.data.data),\n\n  update: (id: string, payload: Partial\u003CUser>) =>\n    apiClient.patch\u003C{ data: User }>(`\u002Fusers\u002F${id}`, payload).then((r) => r.data.data),\n\n  delete: (id: string) =>\n    apiClient.delete(`\u002Fusers\u002F${id}`),\n};\n```\n\n### Data Fetching with TanStack Query\n\n```typescript\n\u002F\u002F src\u002Fhooks\u002FuseUsers.ts\nimport { useQuery, useMutation, useQueryClient } from \"@tanstack\u002Freact-query\";\nimport { usersApi, ApiError } from \"@\u002Fapi\u002Fusers\";\nimport { AxiosError } from \"axios\";\n\nexport const userKeys = {\n  all: [\"users\"] as const,\n  list: (params?: object) => [...userKeys.all, \"list\", params] as const,\n  detail: (id: string) => [...userKeys.all, \"detail\", id] as const,\n};\n\nexport function useUsers(params?: { status?: string; page?: number; size?: number }) {\n  return useQuery({\n    queryKey: userKeys.list(params),\n    queryFn: () => usersApi.list(params),\n    staleTime: 30_000,\n  });\n}\n\nexport function useUser(id: string) {\n  return useQuery({\n    queryKey: userKeys.detail(id),\n    queryFn: () => usersApi.getById(id),\n    enabled: !!id,\n  });\n}\n\nexport function useCreateUser() {\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: usersApi.create,\n    onSuccess: () => queryClient.invalidateQueries({ queryKey: userKeys.all }),\n  });\n}\n\nexport function useDeleteUser() {\n  const queryClient = useQueryClient();\n  return useMutation({\n    mutationFn: usersApi.delete,\n    onSuccess: () => queryClient.invalidateQueries({ queryKey: userKeys.all }),\n  });\n}\n```\n\n### API Error Handling in Components\n\n```typescript\n\u002F\u002F src\u002Futils\u002FapiError.ts\nimport { AxiosError } from \"axios\";\nimport { ApiError } from \"@\u002Fapi\u002Fusers\";\n\nexport function extractApiError(error: unknown): string {\n  if (error instanceof AxiosError) {\n    const data = error.response?.data as ApiError | undefined;\n    return data?.error?.message ?? \"An unexpected error occurred\";\n  }\n  return \"An unexpected error occurred\";\n}\n\nexport function extractFieldErrors(\n  error: unknown\n): Record\u003Cstring, string> {\n  if (error instanceof AxiosError) {\n    const data = error.response?.data as ApiError | undefined;\n    return Object.fromEntries(\n      (data?.error?.details ?? []).map((d) => [d.field, d.message])\n    );\n  }\n  return {};\n}\n```\n\n```tsx\n\u002F\u002F src\u002Fcomponents\u002FCreateUserForm.tsx\nimport { useState } from \"react\";\nimport { useCreateUser } from \"@\u002Fhooks\u002FuseUsers\";\nimport { extractApiError, extractFieldErrors } from \"@\u002Futils\u002FapiError\";\n\nexport function CreateUserForm() {\n  const { mutate, isPending, error } = useCreateUser();\n  const fieldErrors = extractFieldErrors(error);\n  const globalError = error ? extractApiError(error) : null;\n\n  const [form, setForm] = useState({ email: \"\", name: \"\" });\n\n  const handleSubmit = (e: React.FormEvent) => {\n    e.preventDefault();\n    mutate(form);\n  };\n\n  return (\n    \u003Cform onSubmit={handleSubmit}>\n      {globalError && \u003Cp role=\"alert\" className=\"text-red-600\">{globalError}\u003C\u002Fp>}\n\n      \u003Clabel>\n        Email\n        \u003Cinput\n          type=\"email\"\n          value={form.email}\n          onChange={(e) => setForm((f) => ({ ...f, email: e.target.value }))}\n          aria-invalid={!!fieldErrors.email}\n        \u002F>\n        {fieldErrors.email && \u003Cspan className=\"text-red-500\">{fieldErrors.email}\u003C\u002Fspan>}\n      \u003C\u002Flabel>\n\n      \u003Clabel>\n        Name\n        \u003Cinput\n          value={form.name}\n          onChange={(e) => setForm((f) => ({ ...f, name: e.target.value }))}\n          aria-invalid={!!fieldErrors.name}\n        \u002F>\n        {fieldErrors.name && \u003Cspan className=\"text-red-500\">{fieldErrors.name}\u003C\u002Fspan>}\n      \u003C\u002Flabel>\n\n      \u003Cbutton type=\"submit\" disabled={isPending}>\n        {isPending ? \"Creating…\" : \"Create User\"}\n      \u003C\u002Fbutton>\n    \u003C\u002Fform>\n  );\n}\n```\n\n### Paginated List Component\n\n```tsx\n\u002F\u002F src\u002Fcomponents\u002FUserList.tsx\nimport { useState } from \"react\";\nimport { useUsers } from \"@\u002Fhooks\u002FuseUsers\";\n\nexport function UserList() {\n  const [page, setPage] = useState(1);\n  const { data, isLoading, isError } = useUsers({ page, size: 20 });\n\n  if (isLoading) return \u003Cp>Loading…\u003C\u002Fp>;\n  if (isError)   return \u003Cp role=\"alert\">Failed to load users.\u003C\u002Fp>;\n\n  return (\n    \u003C>\n      \u003Cul>\n        {data?.data.map((user) => (\n          \u003Cli key={user.id}>{user.name} — {user.email}\u003C\u002Fli>\n        ))}\n      \u003C\u002Ful>\n\n      \u003Cnav aria-label=\"Pagination\">\n        \u003Cbutton onClick={() => setPage((p) => p - 1)} disabled={page === 1}>\n          Previous\n        \u003C\u002Fbutton>\n        \u003Cspan>Page {data?.meta.page} of {data?.meta.totalPages}\u003C\u002Fspan>\n        \u003Cbutton\n          onClick={() => setPage((p) => p + 1)}\n          disabled={page === data?.meta.totalPages}\n        >\n          Next\n        \u003C\u002Fbutton>\n      \u003C\u002Fnav>\n    \u003C\u002F>\n  );\n}\n```\n\n---\n\n## Versioning\n\n### URL Path Versioning (Recommended)\n\n```\n\u002Fapi\u002Fv1\u002Fusers\n\u002Fapi\u002Fv2\u002Fusers\n```\n\n```java\n\u002F\u002F Spring Boot: version via RequestMapping prefix\n@RestController\n@RequestMapping(\"\u002Fapi\u002Fv1\u002Fusers\")\npublic class UserV1Controller { \u002F* ... *\u002F }\n\n@RestController\n@RequestMapping(\"\u002Fapi\u002Fv2\u002Fusers\")\npublic class UserV2Controller { \u002F* ... *\u002F }\n\n\u002F\u002F Or via a single controller with path differentiation\n@GetMapping({\"\u002Fapi\u002Fv1\u002Fusers\", \"\u002Fapi\u002Fv2\u002Fusers\"})\n```\n\n### Versioning Strategy\n\n```\n1. Start with \u002Fapi\u002Fv1\u002F — don't version until you need to\n2. Maintain at most 2 active versions (current + previous)\n3. Deprecation timeline:\n   - Announce deprecation (6 months notice for public APIs)\n   - Add Sunset header: Sunset: Sat, 01 Jan 2026 00:00:00 GMT\n   - Return 410 Gone after sunset date\n4. Non-breaking changes don't need a new version:\n   - Adding new fields to responses\n   - Adding new optional query parameters\n   - Adding new endpoints\n5. Breaking changes require a new version:\n   - Removing or renaming fields\n   - Changing field types\n   - Changing URL structure\n   - Changing authentication method\n```\n\n---\n\n## application.yml: Key Settings\n\n```yaml\nspring:\n  jackson:\n    default-property-inclusion: non_null          # omit null fields\n    serialization:\n      write-dates-as-timestamps: false            # ISO-8601 dates\n    deserialization:\n      fail-on-unknown-properties: false           # tolerate extra fields\n\n  data:\n    web:\n      pageable:\n        default-page-size: 20\n        max-page-size: 100\n        one-indexed-parameters: true              # page=1 instead of page=0\n\nserver:\n  error:\n    include-message: never                        # hide Spring's default error messages\n    include-stacktrace: never\n```\n\n---\n\n## API Design Checklist\n\nBefore shipping a new endpoint:\n\n- [ ] Resource URL follows naming conventions (plural, kebab-case, no verbs)\n- [ ] Correct HTTP method used (GET for reads, POST for creates, etc.)\n- [ ] Appropriate status codes returned (not 200 for everything)\n- [ ] Input validated with `@Valid` + Bean Validation annotations\n- [ ] `@RestControllerAdvice` handles all exception types consistently\n- [ ] Pagination implemented for list endpoints (`Pageable` or cursor)\n- [ ] Authentication required (Spring Security) or explicitly permitted\n- [ ] Authorization checked (`@PreAuthorize`, ownership check in service)\n- [ ] Rate limiting configured (Bucket4j filter)\n- [ ] Response never leaks internal details (stack traces, SQL errors)\n- [ ] Consistent `camelCase` naming across all responses\n- [ ] React API layer uses typed functions + TanStack Query\n- [ ] Field-level errors surfaced in forms via `details[]` array\n- [ ] OpenAPI\u002FSwagger spec updated (`springdoc-openapi`)",{"name":5,"metadata":24,"description":7},{"origin":25},"AgentPowerHouse - APH","main","2ee82a0e0feb330a9ca82ac22e29268605a07a97","plugins\u002Fcore\u002Fskills\u002Fapi-design",0,"https:\u002F\u002Fgithub.com\u002Fzeeroiq\u002Fagent-powerhouse","https:\u002F\u002Fgithub.com\u002Fzeeroiq","2026-09-14 03:10:44",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add zeeroiq\u002Fagent-powerhouse --skill api-design",{"tool":39,"command":40},"bunx","bunx skills add zeeroiq\u002Fagent-powerhouse --skill api-design",{"tool":42,"command":43},"pnpm","pnpm dlx skills add zeeroiq\u002Fagent-powerhouse --skill api-design","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fzeeroiq\u002Fagent-powerhouse\u002Fblob\u002Fmain\u002Fplugins\u002Fcore\u002Fskills\u002Fapi-design\u002FSKILL.md",true,[],[48,55,62,69,76,83],{"skillNo":49,"name":50,"nameZh":6,"description":51,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":52,"categories":53,"keywords":54,"publishedAt":19},"01M75TK43N4Y1HHF88DJ95XDSC","springboot-verification","Verification loop for Spring Boot projects: build, static analysis, tests with coverage, security scans, and diff review before release or PR.","https:\u002F\u002Fgithub.com\u002Fzeeroiq\u002Fagent-powerhouse\u002Fblob\u002Fmain\u002Fplugins\u002Fjava\u002Fskills\u002Fspringboot-verification\u002FSKILL.md",[],[],{"skillNo":56,"name":57,"nameZh":6,"description":58,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":19},"01M75TK18END7AKP4FQMSFEB4B","springboot-tdd","Test-driven development for Spring Boot using JUnit 5, Mockito, MockMvc, Testcontainers, and JaCoCo. Use when adding features, fixing bugs, or refactoring.","https:\u002F\u002Fgithub.com\u002Fzeeroiq\u002Fagent-powerhouse\u002Fblob\u002Fmain\u002Fplugins\u002Fjava\u002Fskills\u002Fspringboot-tdd\u002FSKILL.md",[],[],{"skillNo":63,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":19},"01M75TJYRM9Z2JQ41QD7G8YSN7","springboot-security","Spring Security best practices for authn\u002Fauthz, validation, CSRF, secrets, headers, rate limiting, and dependency security in Java Spring Boot services.","https:\u002F\u002Fgithub.com\u002Fzeeroiq\u002Fagent-powerhouse\u002Fblob\u002Fmain\u002Fplugins\u002Fjava\u002Fskills\u002Fspringboot-security\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":19},"01M75TJV6FW8P7S0RE2PYB5S49","springboot-patterns","Spring Boot architecture patterns, REST API design, layered services, data access, caching, async processing, and logging. Use for Java Spring Boot backend work.","https:\u002F\u002Fgithub.com\u002Fzeeroiq\u002Fagent-powerhouse\u002Fblob\u002Fmain\u002Fplugins\u002Fjava\u002Fskills\u002Fspringboot-patterns\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":19},"01M75TJQVREKZ4DWT5DMX1Z3R5","quarkus-tdd","Test-driven development for Quarkus 3.x LTS using JUnit 5, Mockito, REST Assured, Camel testing, and JaCoCo. Use when adding features, fixing bugs, or refactoring event-driven services.","https:\u002F\u002Fgithub.com\u002Fzeeroiq\u002Fagent-powerhouse\u002Fblob\u002Fmain\u002Fplugins\u002Fjava\u002Fskills\u002Fquarkus-tdd\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":19},"01M75TJM4P1G4WZ523TKHSQ4GZ","quarkus-security","Quarkus Security best practices for authentication, authorization, JWT\u002FOIDC, RBAC, input validation, CSRF, secrets management, and dependency security.","https:\u002F\u002Fgithub.com\u002Fzeeroiq\u002Fagent-powerhouse\u002Fblob\u002Fmain\u002Fplugins\u002Fjava\u002Fskills\u002Fquarkus-security\u002FSKILL.md",[],[]]