API Documentation

通过 REST API 以编程方式访问 SkillWink 技能数据，支持关键词检索和 AI 语义检索。

目录：Authentication · Endpoints · Code Examples · Error Handling

Authentication

请先登录后创建和管理 API Key。

Base URL

/api/v1

Header: Authorization: Bearer sk_live_skillwink_xxx

Endpoints

GET

/api/v1/skills/search

Search skills using keywords

GET

/api/v1/skills/ai-search

AI semantic search powered by lightweight semantic matching

GET /api/v1/skills/search

Parameter	Type	Required	Description
q	string	yes	Search query
page	number	no	Page number (default: 1)
limit	number	no	Items per page (default: 20, max: 100)
sortBy	string	no	Sort: recent \| downloads \| likes \| comments
category	string	no	Filter by category

GET /api/v1/skills/ai-search

Parameter	Type	Required	Description
q	string	yes	AI semantic search query
page	number	no	Page number (default: 1)
limit	number	no	Items per page (default: 20, max: 100)

Code Examples

Keyword Search

curl -X GET "http://www.skillwink.com/api/v1/skills/search?q=design" \
  -H "Authorization: Bearer sk_live_skillwink_your_api_key"

const resp = await fetch("http://www.skillwink.com/api/v1/skills/search?q=design", {
  headers: { Authorization: "Bearer sk_live_skillwink_your_api_key" }
});
const data = await resp.json();

import requests
r = requests.get(
    "http://www.skillwink.com/api/v1/skills/search",
    params={"q": "design"},
    headers={"Authorization": "Bearer sk_live_skillwink_your_api_key"},
    timeout=20,
)
print(r.json())

AI Semantic Search

curl -X GET "http://www.skillwink.com/api/v1/skills/ai-search?q=how+to+write+a+report" \
  -H "Authorization: Bearer sk_live_skillwink_your_api_key"

const resp = await fetch("http://www.skillwink.com/api/v1/skills/ai-search?q=how+to+write+a+report", {
  headers: { Authorization: "Bearer sk_live_skillwink_your_api_key" }
});
const data = await resp.json();

import requests
r = requests.get(
    "http://www.skillwink.com/api/v1/skills/ai-search",
    params={"q": "how to write a report"},
    headers={"Authorization": "Bearer sk_live_skillwink_your_api_key"},
    timeout=20,
)
print(r.json())

Error Handling

API 使用标准 HTTP 状态码并返回 JSON 错误信息。

Error Code	HTTP	Description
MISSING_API_KEY	401	API key not provided
INVALID_API_KEY	401	Invalid API key
MISSING_QUERY	400	Missing required query parameter
RATE_LIMITED	429	Rate limit exceeded
INTERNAL_ERROR	500	Internal server error

Error Response Example

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Invalid API key."
  }
}