Exécutez n'importe quel Skill dans Manus
en un clic

Exécutez n'importe quel Skill dans Manus en un clic

api-design

Étoiles26

Forks4

Mis à jour30 mars 2026 à 02:57

REST API design guide for new endpoints — RESTful URL structure, query parameter binding rules (@RequestParam vs @ModelAttribute), OpenAPI annotations, and CommonApiResponse usage.

Installation

Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.

Exécuter dans Manus

Source

themoment-team

themoment-team/datagsm-server

Ouvrir le dépôt GitHub Voir les dépôts du créateur

Téléchargement

Exécuter dans Manus

Métiers associésSOC

Basé sur la classification professionnelle SOC

Développeurs de logicielsProfessions informatiques et mathématiques·SOC 15-1252

SKILL.md

readonly

name	api-design
description	REST API design guide for new endpoints — RESTful URL structure, query parameter binding rules (@RequestParam vs @ModelAttribute), OpenAPI annotations, and CommonApiResponse usage.

REST API Design Guide

URL Design

RESTful principles: /v1/auth/api-keys
Use plural: /students, /clubs
Hierarchy: /students/{id}/projects

Query Parameters

Filtering: ?status=active
Pagination: ?page=0&size=20
Sorting: ?sort=createdAt,desc

OpenAPI Documentation

@Operation(summary = "Create API key", description = "...")
@ApiResponse(responseCode = "200", description = "Success")
@PostMapping("/api-keys")
fun create(@Valid @RequestBody reqDto: CreateApiKeyReqDto): CommonApiResponse<ApiKeyResDto>

Response Format

Success: CommonApiResponse(data = ...)
Error: ExpectedException → Global Handler

Plus depuis ce dépôt

même dépôt

the-sdk

themoment-team/datagsm-server

Usage guide for the-sdk common library — HTTP request/response logging with UUID Log-ID, CommonApiResponse wrapping, ExpectedException handling, and Swagger auto-configuration.

2026-06-2326

database-schema

themoment-team/datagsm-server

Database schema design guide — table naming, column conventions, index strategy, and JPA entity mapping patterns.

2026-05-2726

docker

themoment-team/datagsm-server

Dockerfile and docker-compose authoring guide — multi-stage builds, layer caching, security best practices, and compose service wiring.

2026-05-2726

database-schema

themoment-team/datagsm-server

Database schema design guide — table naming, column conventions, index strategy, and JPA entity mapping patterns.

2026-05-2726

planning

themoment-team/datagsm-server

Conduct an in-depth structured interview with the user to uncover non-obvious requirements, tradeoffs, and constraints, then produce a detailed implementation spec file.

2026-05-2726

planning

themoment-team/datagsm-server

Conduct an in-depth structured interview with the user to uncover non-obvious requirements, tradeoffs, and constraints, then produce a detailed implementation spec file.

2026-05-2626

name	api-design
description	REST API design guide for new endpoints — RESTful URL structure, query parameter binding rules (@RequestParam vs @ModelAttribute), OpenAPI annotations, and CommonApiResponse usage.

REST API Design Guide

URL Design

RESTful principles: /v1/auth/api-keys
Use plural: /students, /clubs
Hierarchy: /students/{id}/projects

Query Parameters

Filtering: ?status=active
Pagination: ?page=0&size=20
Sorting: ?sort=createdAt,desc

OpenAPI Documentation

@Operation(summary = "Create API key", description = "...")
@ApiResponse(responseCode = "200", description = "Success")
@PostMapping("/api-keys")
fun create(@Valid @RequestBody reqDto: CreateApiKeyReqDto): CommonApiResponse<ApiKeyResDto>

Response Format

Success: CommonApiResponse(data = ...)
Error: ExpectedException → Global Handler