名称： jo4
描述： URL 短链接生成器、二维码生成器和链接分析 API。可创建短链接、生成二维码并追踪点击分析。
主页： https://jo4.io
user-invocable: true
元数据： { "openclaw": { "emoji": "🔗", "primaryEnv": "JO4_API_KEY", "requires": { "env": ["JO4_API_KEY"] } } }

Jo4 - URL 短链接与分析 API

Jo4 是一个集成了二维码生成和详细链接分析功能的现代化 URL 短链接服务。

认证

所有受保护的接口都需要 API 密钥。请将您的 API 密钥设置为环境变量：

export JO4_API_KEY="your-api-key"

从以下地址获取您的 API 密钥：https://jo4.io/api-keys

API 基础 URL

https://jo4-api.jo4.io/api/v1

接口

创建短链接（需认证）

curl -X POST "https://jo4-api.jo4.io/api/v1/protected/url" \
  -H "X-API-Key: $JO4_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "longUrl": "https://example.com/very-long-url",
    "title": "我的链接"
  }'

请求体参数：
- longUrl (必填) - 目标 URL（最长 2048 个字符）
- title (可选) - 链接标题（最长 200 个字符）
- description (可选) - 链接描述（最长 500 个字符）
- shortUrl (可选) - 自定义别名（最长 16 个字符，仅限字母、数字、连字符和下划线）
- expirationTime (可选) - 链接过期时间的 Unix 时间戳
- passwordProtected (可选) - 布尔值，启用密码保护
- password (可选) - 密码（若启用保护，4-128 个字符）

UTM 参数：
- utmSource, utmMedium, utmCampaign, utmTerm, utmContent

响应示例：

{
  "response": {
    "id": 123,
    "slug": "abc123",
    "shortUrl": "abc123",
    "fullShortUrl": "https://jo4.io/a/abc123",
    "longUrl": "https://example.com/very-long-url",
    "title": "我的链接",
    "qrCodeUrl": "https://jo4.io/qr/abc123"
  }
}

创建匿名短链接（无需认证）

curl -X POST "https://jo4-api.jo4.io/api/v1/public/url" \
  -H "Content-Type: application/json" \
  -d '{"longUrl": "https://example.com"}'

功能有限，且无法访问分析数据。

获取链接详情

curl -X GET "https://jo4-api.jo4.io/api/v1/protected/url/{slug}" \
  -H "X-API-Key: $JO4_API_KEY"

获取链接分析数据

curl -X GET "https://jo4-api.jo4.io/api/v1/protected/url/{slug}/stats" \
  -H "X-API-Key: $JO4_API_KEY"

响应包含：
- 总点击量
- 按日期统计的点击量
- 地理位置分布
- 设备/浏览器细分
- 来源引荐

列出我的所有链接

curl -X GET "https://jo4-api.jo4.io/api/v1/protected/url/myurls?page=0&size=20" \
  -H "X-API-Key: $JO4_API_KEY"

更新链接

curl -X PUT "https://jo4-api.jo4.io/api/v1/protected/url/{id}" \
  -H "X-API-Key: $JO4_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "更新后的标题",
    "longUrl": "https://new-destination.com"
  }'

删除链接

curl -X DELETE "https://jo4-api.jo4.io/api/v1/protected/url/{id}" \
  -H "X-API-Key: $JO4_API_KEY"

二维码

每个短链接都会自动生成一个二维码，地址为：

https://jo4.io/qr/{shortUrl}

速率限制

速率限制因套餐而异：
- 免费版：60 次请求/分钟
- 专业版：最高 10,000 次请求/分钟
- 匿名（公共接口）：10 次请求/分钟

API 文档

完整的 OpenAPI/Swagger 文档：https://jo4-api.jo4.io/swagger-ui/index.html

常见用例

1. 生成用于分享的短链接

curl -X POST "https://jo4-api.jo4.io/api/v1/protected/url" \
  -H "X-API-Key: $JO4_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"longUrl": "https://example.com/article", "title": "文章"}'

2. 创建营销活动追踪链接

curl -X POST "https://jo4-api.jo4.io/api/v1/protected/url" \
  -H "X-API-Key: $JO4_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "longUrl": "https://mysite.com/landing",
    "title": "第一季度活动",
    "utmSource": "twitter",
    "utmMedium": "social",
    "utmCampaign": "q1-2026"
  }'

3. 创建有时效性的链接

curl -X POST "https://jo4-api.jo4.io/api/v1/protected/url" \
  -H "X-API-Key: $JO4_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "longUrl": "https://mysite.com/promo",
    "title": "限时优惠",
    "expirationTime": 1738454400
  }'

错误代码