API 문서

REST API를 통해 SkillsMP Skills 데이터에 프로그래밍 방식으로 접근하세요. 키워드 검색과 카테고리, 직업 및 감지된 Skill 콘텐츠 언어 필터를 지원합니다.

table_of_contents.md

인증

엔드포인트

GET /api/v1/skills/search

키워드로 스킬 검색

파라미터	타입	필수	설명
q	string	✓	검색 쿼리
page	number	-	페이지 번호 (기본: 1)
limit	number	-	페이지당 항목 수 (기본: 20, 최대: 100)
sortBy	string	-	정렬: stars \| recent (기본: recent)
category	string	-	카테고리 slug로 필터링합니다(예: data-ai, devops).
occupation	string	-	SOC 직업 slug로 필터링합니다(예: software-developers).
language	string	-	Skill 본문에서 감지된 언어로 필터링합니다. en, zh, ja 같은 ISO 언어 코드를 사용하며, mul은 혼합 언어, und는 판별 불가를 의미합니다.

속도 제한

*익명 접근 (API 키 불필요): 50회/일, 10회/분 — 키워드 검색만
*인증됨 (API 키 사용): 500회/일, 30회/분 — 키워드 검색
*와일드카드 검색(예: *)은 지원되지 않습니다

모든 API 응답에는 쿼터 사용량을 추적할 수 있는 다음 헤더가 포함됩니다:

헤더	설명
X-RateLimit-Daily-Limit	일일 요청 제한
X-RateLimit-Daily-Remaining	오늘 남은 요청 수

코드 예제

키워드 검색

curl -X GET "https://skillsmp.com/api/v1/skills/search?q=SEO" \
  -H "Authorization: Bearer sk_live_your_api_key"

직업 필터로 검색

curl -X GET "https://skillsmp.com/api/v1/skills/search?q=automation&occupation=software-developers&language=zh&sortBy=stars" \
  -H "Authorization: Bearer sk_live_your_api_key"

에러 처리

API는 표준 HTTP 상태 코드를 사용하며 JSON 형식으로 에러 세부 정보를 반환합니다.

에러 코드	HTTP	설명
INVALID_API_KEY	401	유효하지 않은 API 키
MISSING_QUERY	400	필수 쿼리 파라미터 누락
INVALID_OCCUPATION	400	알 수 없는 직업 slug
INVALID_LANGUAGE	400	알 수 없는 콘텐츠 언어 코드
DAILY_QUOTA_EXCEEDED	429	일일 API 쿼터 초과
INTERNAL_ERROR	500	서버 내부 오류

에러 응답 예제:

json

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "The provided API key is invalid"
  }
}

more.md

문서로 돌아가기