您可以将 XAPI 简单理解为：一个开箱即用的开发者后端工具箱。

它提供了一系列通用的后端 API 服务，旨在让您无需编写一行后端代码，即可为您的应用快速集成动态内容、数据统计等功能。您只需专注于您的核心业务和前端开发，XAPI 负责提供稳定、高性能的底层支持。

• 统一 API 入口：所有服务均通过 api.xabcstack.com 提供，接口设计遵循 RESTful 风格，简洁易用。
• 高性能架构：内置多级缓存（内存、Redis），确保高并发下的毫秒级响应，为您的应用提供流畅体验。
• 事件驱动设计：服务间通过事件总线解耦，保证了系统的高内聚和数据一致性。

---

核心服务

XAPI 目前已上线两大服务：动态卡片服务 和 URL 统计服务。

1. X-CARD 动态卡片服务

X-CARD 是一个轻量级、动态化的内容下发系统，非常适合用于应用内的 公告、通知、运营活动卡片、Dashboard 信息模块 等场景，当前网站主页右侧卡片即由 X-CARD 提供支持。

• 核心能力:
  • 动态创建：通过 API 随时创建包含标题、内容、图片和跳转链接的卡片。
  • 优先级排序：设置卡片优先级，智能控制前端展示顺序。
  • 自动过期：为卡片设置有效期，到期后自动下线，无需手动管理。
  • 展示控制：可限制每张卡片的最大展示次数，实现精准投放。

2. X-STATS URL 统计服务

X-STATS 是一个简单、无 Cookie 的访问统计服务，用于轻量级地追踪页面或链接的访问数据，对访客隐私友好，当前页面下方的数据统计即由 X-STATS 提供支持。

• 核心能力:
  • 访问追踪：一行代码即可追踪任何 URL 的访问次数 (PV)。
  • 来源分析：自动解析并统计访问来源域名 (Referer)。
  • 数据看板：提供热门 URL 和热门来源排行榜，快速了解流量分布。
  • 数据概览：提供用户维度的总访问量、总来源数等聚合数据。

---

API 快速上手

注册成功后，您会获得两种密钥：

• API 密钥 (sk-...): 用于执行创建、修改、删除等需要安全认证的操作。
• 公共密钥 (pk-...): 用于执行数据追踪、公开数据查询等可以暴露在前端的操作。

示例 1: 创建一张公告卡片 (使用 API 密钥)

使用您的 sk- 密钥创建一个有效期为 7 天的公告卡片。

export XAPI-KEY="你的XAPI-KEY" # sk- 开头的密钥

curl -X POST https://api.xabcstack.com/x-card \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAPI-KEY" \
  -d '{
      "title": "🎉 新功能上线！",
      "content": "我们的 URL 统计服务现已全面开放，快来体验吧！",
      "link": "https://stats.xabcstack.com",
      "priority": 10,
      "days": 7
    }'

示例 2: 在前端获取并展示卡片 (使用公共密钥)

在您的网站或 App 中，使用 pk- 公钥获取所有有效的卡片并展示。

export XAPI_PUBLIC_KEY="你的-公共-密钥" # pk- 开头的公钥

curl -X GET "https://api.xabcstack.com/x-card/${XAPI_PUBLIC_KEY}"

示例 3: 在前端追踪一次页面访问 (使用公共密钥)

将此请求嵌入在您的网站前端代码中，即可追踪页面访问。

export XAPI_PUBLIC_KEY="你的-公共-密钥" # pk- 开头的公钥

curl -X POST "https://api.xabcstack.com/x-urls/${XAPI_PUBLIC_KEY}/track" \
  -H "Content-Type: application/json" \
  -H "Referer: https://www.google.com/" \
  -d '{
      "url": "https://yoursite.com/pricing"
    }'

示例 4: 获取统计数据概览 (使用公共密钥)

获取您的账户下所有 URL 的统计概览，包括总访问量、热门 URL Top 10 等。

export XAPI_PUBLIC_KEY="你的-公共-密钥" # pk- 开头的公钥

curl -X GET "https://api.xabcstack.com/x-urls/${XAPI_PUBLIC_KEY}/overview?limit=10"