开发者中心

API文档

通过API集成Openclaw跨境甄选的Skill数据到您的应用

Base URL: kuajingzhenxuan.com/api

HTTPS Only

接口概述

Openclaw跨境甄选提供RESTful API，允许开发者访问平台上的Skill数据、分类信息，以及下载Skill文件。所有API响应均使用JSON格式，采用标准HTTP状态码。

RESTful

标准REST架构

JSON

JSON数据格式

HTTPS

安全加密传输

认证

公开API（如获取Skill列表、详情）无需认证即可访问。管理API（如创建、修改Skill）需要管理员权限，通过JWT Token认证。

认证Header

Authorization: Bearer <your-jwt-token>

API端点

GET/api/skills

获取Skill列表

请求参数

参数	类型	必需	说明
page	number	否	页码
limit	number	否	每页数量
category	string	否	分类slug
search	string	否	搜索关键词

响应示例

{
  "success": true,
  "data": {
    "skills": [
      {
        "id": "uuid",
        "skill_id": "amazon-product-research",
        "name_zh": "亚马逊选品助手",
        "description_zh": "基于AI的选品分析工具",
        "category_name": "智能选品",
        "version": "1.2.0",
        "rating": 4.8,
        "install_count": 1250
      }
    ],
    "pagination": {
      "total": 156,
      "page": 1,
      "totalPages": 8
    }
  }
}

GET/api/skills/:id

获取单个Skill详情

请求参数

参数	类型	必需	说明
id	string	是	Skill ID或skill_id

响应示例

{
  "success": true,
  "data": {
    "id": "uuid",
    "skill_id": "amazon-product-research",
    "name_zh": "亚马逊选品助手",
    "name_en": "Amazon Product Research",
    "description_zh": "详细描述...",
    "version": "1.2.0",
    "platforms": ["amazon"],
    "tags": ["选品", "竞品分析"],
    "author": "OpenClaw Team",
    "download_url": "https://kuajingzhenxuan.com/api/download/amazon-product-research"
  }
}

GET/api/download/:skillId

下载Skill文件

请求参数

参数	类型	必需	说明
skillId	string	是	Skill ID

响应示例

返回zip文件流

GET/api/categories

获取所有分类

响应示例

{
  "success": true,
  "data": [
    {
      "id": "uuid",
      "slug": "product-research",
      "name_zh": "智能选品",
      "name_en": "Product Research",
      "description_zh": "市场调研、竞品分析",
      "color": "#3B82F6",
      "skill_count": 25
    }
  ]
}

POST/api/admin/skills需认证

创建新Skill（需要管理员权限）

请求体

{
  "skill_id": "string",       // 唯一标识
  "name_zh": "string",        // 中文名称
  "name_en": "string",        // 英文名称
  "description_zh": "string", // 中文描述
  "category_slug": "string",  // 分类slug
  "platforms": ["string"],    // 支持平台
  "tags": ["string"],         // 标签
  "version": "string",        // 版本号
  "source_url": "string",     // 源码地址
  "author": "string"          // 作者
}

响应示例

{
  "success": true,
  "data": {
    "id": "uuid",
    "message": "Skill创建成功"
  }
}

代码示例

cURL

# 获取Skill列表
curl -X GET "https://kuajingzhenxuan.com/api/skills?page=1&limit=10" \
  -H "Content-Type: application/json"

# 获取单个Skill
curl -X GET "https://kuajingzhenxuan.com/api/skills/amazon-product-research" \
  -H "Content-Type: application/json"

# 下载Skill文件
curl -X GET "https://kuajingzhenxuan.com/api/download/amazon-product-research" \
  -H "Content-Type: application/json" \
  --output amazon-product-research.zip

JavaScript

// 使用 fetch API
const response = await fetch('https://kuajingzhenxuan.com/api/skills');
const data = await response.json();

console.log(data.data.skills);

// 下载Skill
const downloadResponse = await fetch(
  'https://kuajingzhenxuan.com/api/download/amazon-product-research'
);
const blob = await downloadResponse.blob();

// 保存文件
const url = window.URL.createObjectURL(blob);
const a = document.createElement('a');
a.href = url;
a.download = 'amazon-product-research.zip';
a.click();

Python

import requests

# 获取Skill列表
response = requests.get(
    'https://kuajingzhenxuan.com/api/skills',
    params={'page': 1, 'limit': 10}
)
data = response.json()

print(f"Total skills: {data['data']['pagination']['total']}")
for skill in data['data']['skills']:
    print(f"- {skill['name_zh']} (v{skill['version']})")

# 下载Skill文件
response = requests.get(
    'https://kuajingzhenxuan.com/api/download/amazon-product-research',
    stream=True
)

with open('amazon-product-research.zip', 'wb') as f:
    for chunk in response.iter_content(chunk_size=8192):
        f.write(chunk)

错误码

状态码	说明
200	请求成功
400	请求参数错误
401	未授权，需要登录
403	禁止访问，权限不足
404	资源不存在
500	服务器内部错误