mirror of https://github.com/iflytek/skillhub.git synced 2026-09-07 08:26:00 +00:00

tww 19329480c8 feat(docs): complete Docusaurus website with bilingual support

Add complete bilingual (Chinese/English) documentation website:
- Chinese documentation in docs/
- English documentation in i18n/en/
- iFlytek blue theme customization
- Role-based navigation structure
- ToB enterprise value-focused content

2026-03-15 18:36:59 +08:00

1.3 KiB

Raw Permalink Blame History

title	sidebar_position	description
API Overview	1	SkillHub API overview

API Overview

SkillHub provides RESTful APIs for integration and automation.

API Categories

Public APIs

Skill search
Skill details
Version list
Download skills
No authentication required (for PUBLIC skills)

Authenticated APIs

Publish skills
Favorites/ratings
Namespace management
Requires login or Bearer Token

CLI Compatibility Layer

ClawHub CLI protocol compatible
Existing tools can migrate seamlessly

Response Format

Unified Response Structure

{
  "code": 0,
  "msg": "Success",
  "data": {},
  "timestamp": "2026-03-15T06:00:00Z",
  "requestId": "req-123"
}

Pagination Response

{
  "code": 0,
  "msg": "Success",
  "data": {
    "items": [],
    "total": 100,
    "page": 1,
    "size": 20
  },
  "timestamp": "2026-03-15T06:00:00Z",
  "requestId": "req-123"
}

Authentication Methods

Web side uses Session Cookie authentication.

Bearer Token

CLI and API integration use Bearer Token:

Authorization: Bearer <token>

API Token

Can create long-lived API Tokens for automation.

Idempotency

All write operations support X-Request-Id header for idempotency:

X-Request-Id: <uuid-v4>

Next Steps

Public APIs - View public endpoints

1.3 KiB Raw Permalink Blame History