企业鉴权接入文档

XSCT AI 技能认证 · 证书验真 API · exam.xsct.ai/developers

无需注册,无需 API Key,直接调用
公开接口对所有人开放,复制下方 curl 即可运行。
默认限速:60 次/分钟/IP,适合个人项目和小型系统对接。
扫码访问 xsct.ai 扫码访问 xsct.ai
微信公众号搜索:洛小山
通常 1 个工作日内回复
1
限速说明
访问方式限速适用场景
匿名(无 Key) 60 次/分钟/IP 个人验证、HR 偶尔查询、小工具集成
API Key(免费申请) 300 次/分钟/Key 企业 HR 系统、ATS 招聘平台、批量查验
超出限速 返回 HTTP 429,响应头含 Retry-After

所有接口均为只读(GET),不涉及数据修改,无安全风险,放心集成。

2
快速上手
# 验证一张证书(无需任何 Key)
curl "https://exam.xsct.ai/api/cert/lookup?id=SLCT-2025-DEV-A8K3M2PQ"

# 批量验证(需 API Key)
curl "https://exam.xsct.ai/api/cert/batch?cert_ids=CERT-001,CERT-002" \
  -H "Authorization: Bearer slct_your_key_here"

示例响应

{
  "cert_id": "abc123",
  "cert_code": "SLCT-2025-DEV-A8K3M2PQ",
  "nickname": "洛小山",
  "direction": "dev",
  "direction_name": "开发岗",
  "grade": "A+",
  "score": 87.5,
  "objective_score": 52.0,  // 客观题得分
  "subjective_score": 35.5,  // 主观题得分
  "issued_at": "2025-06-15T10:30:00",
  "expires_at": "2026-06-15T10:30:00",
  "exam_started_at": "2025-06-15T09:28:00",
  "exam_submitted_at": "2025-06-15T10:18:42",
  "exam_duration_seconds": 3042,  // 实际用时 50 分 42 秒
  "violation_count": 0,  // 违规次数(切屏、失焦等)
  "is_valid": true,
  "void_reason": null,
  "verify_url": "https://exam.xsct.ai/verify?id=SLCT-...",
  "dimensions": {  // 各维度得分(0-100)
    "prompt_engineering": 88,
    "ai_tools_proficiency": 91,
    "workflow_design": 82,
    "code_gen_debugging": 85
  }
}
3
MCP 接入(Cursor / Claude 等)

~/.cursor/mcp.json 中添加以下配置,AI Agent 即可直接通过自然语言调用:

{
  "mcpServers": {
    "xsct-exam": {
      "url": "https://exam.xsct.ai/mcp",
      "note": "XSCT AI 技能认证查询 - 无需鉴权,开箱即用"
    }
  }
}
4
错误码对照表
codeHTTP含义
0200成功
4001404证书编号不存在
4002200证书已过期(数据存在,有效期已过)
4003200证书已作废(考试违规)
4004400参数缺失或格式错误
4291429超出限速,稍后重试
4011401API Key 无效或已禁用
5
动态认证徽章
✓ XSCT 认证 · A+ · 有效
XSCT 认证 · 已过期
✗ XSCT 认证 · 已作废
# Markdown
[![XSCT 认证](https://exam.xsct.ai/badge/SLCT-2025-DEV-A8K3M2PQ)](https://exam.xsct.ai/verify?id=SLCT-2025-DEV-A8K3M2PQ)

# HTML
<a href="https://exam.xsct.ai/verify?id=SLCT-2025-DEV-A8K3M2PQ">
  <img src="https://exam.xsct.ai/badge/SLCT-2025-DEV-A8K3M2PQ" alt="XSCT AI 技能认证 A+" />
</a>

动态 SVG:绿色=有效 · 灰色=过期 · 红色=作废,实时反映证书状态