REST, GraphQL, 인증 및 테스트 스위트를 포함하여 프로덕션 준비가 된 API 스캐폴드를 생성하기 위한 강력한 CLI 유틸리티입니다.
설치 및 다운로드
1. ClawHub CLI
레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.
npx clawhub@latest install api-generator
2. 수동 설치
스킬 폴더를 다음 위치 중 하나로 복사하세요
~/.openclaw/skills/ <project>/skills/ 우선순위: 워크스페이스 > 로컬 > 번들
3. 프롬프트 설치
이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.
Clawhub를 사용해서 api-generator 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).
다운로드를 원하시나요?
ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.
API Generator란 무엇인가요?
API Generator는 백엔드 스캐폴딩의 반복적인 작업을 제거하도록 설계된 개발자 중심의 유틸리티입니다. Openclaw Skills 에코시스템의 핵심 구성 요소로서 RESTful 엔드포인트, GraphQL 스키마 및 OpenAPI 문서를 위한 고품질 코드를 생성하기 위한 간소화된 인터페이스를 제공합니다. 마이크로서비스를 처음부터 구축하든 기존 프로젝트에 새로운 리소스를 추가하든 이 도구는 API 아키텍처가 일관되고 문서화가 잘 되어 있으며 안전함을 보장합니다.
이 스킬을 활용함으로써 개발자는 상용구 코드 대신 비즈니스 로직에 집중할 수 있습니다. 생성된 코드는 최신 환경에 최적화되어 있으며 웹 서비스용 Express.js를 지원하고 Python에서 강력한 클라이언트 라이브러리를 제공합니다. 즉각적인 모크 서버와 포괄적인 테스트 스위트를 제공하여 설계와 구현 사이의 격차를 좁히므로 신속한 프로토타이핑과 프로덕션 개발 모두에 필수적인 도구입니다.
API Generator 활용 사례
- Express.js를 사용하여 RESTful CRUD 서비스를 신속하게 부트스트래핑합니다.
- 유형, 쿼리 및 뮤테이션을 포함한 복잡한 GraphQL 스키마를 설계합니다.
- 팀 협업을 개선하기 위해 OpenAPI 3.0/Swagger 문서를 자동으로 생성합니다.
- 최소한의 노력으로 JWT, OAuth 또는 API Keys와 같은 안전한 인증 흐름을 구현합니다.
- 개발 중 엔드포인트를 검증하기 위해 모크 API 서버 및 Jest 테스트 스위트를 생성합니다.
API Generator 작동 원리
- API를 통해 노출해야 하는 리소스 또는 데이터 모델을 식별합니다.
- 원하는 프로토콜 명령(예: rest 또는 graphql)을 사용하여 Openclaw Skills 라이브러리에서 apigen.sh 스크립트를 실행합니다.
- 명령 옵션을 통해 인증 유형 또는 속도 제한 전략과 같은 추가 요구 사항을 지정합니다.
- 도구가 요청을 처리하고 주석이 완벽하게 달린 프로덕션급 코드를 생성합니다.
- stdout에서 출력을 캡처하여 프로젝트 파일로 직접 파이프하거나 터미널에서 검토합니다.
API Generator 설정 가이드
Openclaw Skills 환경 내에서 이 도구를 사용하려면 프로젝트 디렉토리에 스크립트가 있고 실행 가능한지 확인하세요.
# Navigate to your skills directory
cd ai-skills
# Ensure the generator script is executable
chmod +x scripts/apigen.sh
# Run a test generation to verify setup
bash scripts/apigen.sh rest health-check
API Generator 데이터 스키마 및 분류 체계
API Generator는 애플리케이션 소스 트리에 직접 통합되도록 의도된 구조화된 코드를 생성합니다. 출력 데이터는 다음과 같이 구성됩니다.
| 데이터 유형 | 형식/언어 | 설명 |
|---|---|---|
| REST Code | JavaScript (Express) | 라우트 및 컨트롤러를 포함한 전체 CRUD 로직 |
| GraphQL | Schema Definition | 유형 정의 및 뮤테이션/쿼리 구조 |
| Docs | OpenAPI 3.0 (YAML/JSON) | 표준화된 API 사양 |
| Clients | Python | 프로그래밍 방식 액세스를 위한 재사용 가능한 클래스 기반 클라이언트 |
| Tests | Jest/Supertest | 자동화된 유닛 및 통합 테스트 |
API Generator 고급 기능
- REST와 GraphQL 아키텍처 간의 원활한 전환을 허용하는 멀티 프로토콜 지원.
- JWT 및 OAuth 2.0 인증의 신속한 배포를 위한 통합 보안 모듈.
- 토큰 버킷 및 슬라이딩 윈도우 구현을 포함한 정교한 속도 제한 옵션.
- 프론트엔드 개발 팀의 병목 현상을 해소하기 위한 자동 모크 서버 생성.
- 기존 Openclaw Skills 자동화 파이프라인에 쉽게 통합할 수 있는 맞춤형 출력 리디렉션.
SKILL.md
로드 중
관련 Openclaw 스킬
Juying IoT 장치 제어
Juying Cloud Platform에서 산업용 및 가정용 IoT 장치를 제어하고 모니터링하기 위한 전문 통합 솔루션입니다.
DocCraft
DocCraft는 원시 소스 자료를 정밀한 포맷팅과 소스 기반 드래프팅을 통해 전문적이고 구조화된 Word 문서로 변환하도록 설계된 전문 AI agent 기술입니다.
중국 이커머스 검색 및 비교
8개의 주요 중국 이커머스 거대 기업을 동시에 검색하여 실시간 가격 비교 및 직접 제품 링크를 제공하는 강력한 크로스 플랫폼 쇼핑 도우미입니다.
SkillBoss
SkillBoss는 단일 인터페이스를 통해 채팅, 이미지, 비디오 및 오디오 작업을 위한 50개 이상의 이질적인 모델에 대한 액세스를 제공하는 통합 AI 게이트웨이입니다.
추천*
