← shxai.space

短链接 API

域名:short.shxai.space

粘贴长链接,一键生成短链

概述

将长 URL 转换为短链,访问短链时自动 302 跳转到目标地址。需要 API Key 鉴权。

AI Agent 使用

不想写代码?下载 url-shortener Skill,直接扔给 AI Agent 读取,Agent 自己就会生成短链。

把这个 Skill 加载进去:
https://shxai.space/skills/url-shortener.md

然后对 Agent 说:
"帮我把这个链接转成短链 https://..."

查看所有 Skills →

POST 创建短链

发送 POST 请求创建短链:

curl -X POST "https://short.shxai.space/create?key=YOUR_API_KEY&url=https://github.com"

响应:

{
  "short": "https://short.shxai.space/a1b2c3",
  "slug": "a1b2c3",
  "url": "https://github.com"
}

GET 访问短链

直接访问短链地址,浏览器会自动跳转:

curl -L https://short.shxai.space/a1b2c3

→ HTTP 302 跳转到原始 URL

参数

参数类型必填说明
keystring是API Key
urlstring是目标 URL,必须是完整格式(含协议)

状态码

状态码含义
200创建成功
302短链跳转
400参数错误(缺少 url、URL 格式无效)
401缺少 API Key
403API Key 无效
404短链不存在

工作原理

POST /create → 验证密钥 → 生成短码 → 返回短链接

GET /:slug  → 查映射表 → 302 跳转或 404