什么是 Jo4 - 短链接与分析 API？

Jo4 是一个全面的链接管理平台，专为不仅需要简单短链接的开发者和营销人员设计。通过在 Openclaw Skills 中集成此工具，用户可以以编程方式缩短 URL、生成自定义别名，并为任何目的地即时创建二维码。它提供专业级的 API，涵盖从基础链接重定向到带 UTM 参数的复杂活动追踪的所有功能。

除了简单的缩短功能，Jo4 还提供对链接表现的深入洞察。它追踪点击率、地理数据、设备类型和来源渠道，使其成为数据驱动决策的重要组成部分。无论您是在构建自动化营销渠道还是管理内部文档链接，Jo4 都能在 Openclaw 生态系统中简化流程。

下载入口:https://github.com/openclaw/skills/tree/main/skills/anandrathnas/jo4

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

Jo4 - 短链接与分析 API 应用场景

• 缩短冗长复杂的 URL，以便在电子邮件、社交媒体或文档中更整洁地分享。
• 为实物营销材料或活动签到生成动态二维码。
• 使用集成的 UTM 参数追踪营销活动表现。
• 创建在特定时间戳后自动失效的时效性链接。
• 在重定向之前通过强制密码保护来确保敏感链接的安全。

1. 技能使用环境设置中提供的安全 API 密钥与 Jo4 API 进行身份验证。
2. 向 API 发送包含目标 URL 和可选元数据（如标题、自定义后缀或过期时间）的请求。
3. Jo4 服务处理请求并返回唯一的后缀和缩短后的 URL。
4. 同时，为新的短链接生成专用的二维码端点，以便立即使用。
5. 当用户点击链接时，系统会捕获遥测数据，稍后可调取这些数据用于实时分析报告。

Jo4 - 短链接与分析 API 配置指南

要在 Openclaw Skills 框架内使用此技能，您必须使用有效的 API 密钥配置环境。

1. 从 Jo4 仪表板 获取您的 API 密钥。
2. 在终端或配置文件中设置环境变量：

export JO4_API_KEY="your-api-key"

Jo4 - 短链接与分析 API 数据架构与分类体系

Jo4 技能通过结构化的响应格式管理数据，其中包括链接元数据和追踪标识符。关键数据点包括：

name: jo4
description: URL shortener, QR code generator, and link analytics API. Create short links, generate QR codes, and track click analytics.
homepage: https://jo4.io
user-invocable: true
metadata: { "openclaw": { "emoji": "??", "primaryEnv": "JO4_API_KEY", "requires": { "env": ["JO4_API_KEY"] } } }

Jo4 - URL Shortener & Analytics API

Jo4 is a modern URL shortening service with QR code generation and detailed link analytics.

Authentication

All protected endpoints require an API key. Set your API key as an environment variable:

export JO4_API_KEY="your-api-key"

Get your API key from: https://jo4.io/api-keys

API Base URL

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

Endpoints

Create Short URL (Authenticated)

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

Request Body:

• longUrl (required) - The destination URL (max 2048 chars)
• title (optional) - Link title (max 200 chars)
• description (optional) - Link description (max 500 chars)
• shortUrl (optional) - Custom alias (max 16 chars, alphanumeric/hyphen/underscore)
• expirationTime (optional) - Unix timestamp for link expiration
• passwordProtected (optional) - Boolean to enable password protection
• password (optional) - Password if protected (4-128 chars)

UTM Parameters:

• utmSource, utmMedium, utmCampaign, utmTerm, utmContent

Response:

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

Create Anonymous Short URL (No Auth Required)

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

Limited features, no analytics access.

Get URL Details

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

Get URL Analytics

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

Response includes:

• Total clicks
• Clicks by date
• Geographic distribution
• Device/browser breakdown
• Referrer sources

List My URLs

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

Update URL

curl -X PUT "https://jo4-api.jo4.io/api/v1/protected/url/{id}" r
  -H "X-API-Key: $JO4_API_KEY" r
  -H "Content-Type: application/json" r
  -d '{
    "title": "Updated Title",
    "longUrl": "https://new-destination.com"
  }'

Delete URL

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

QR Codes

Every short URL automatically gets a QR code at:

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

Rate Limits

Rate limits vary by plan:

• Free: 60 requests/minute
• Pro: Up to 10,000 requests/minute
• Anonymous (public endpoints): 10 requests/minute

API Documentation

Full OpenAPI/Swagger documentation: https://jo4-api.jo4.io/swagger-ui/index.html

Common Use Cases

1. Shorten a URL for sharing

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

2. Create campaign tracking link

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

3. Create expiring link

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

Error Codes