API 接口文档

接口地址

必填参数：url（目标网址）· 可选：expire（小时数，0=永久）、link（长链接模式完整 URL）、jump_mode（auto/confirm）、key（你的 API 密钥，从 后台 获取；用浏览器调用可不带，会自动带登录态）。

{
  "success": true,
  "code": "xY7k",
  "path_prefix": "aB3",
  "short_url": "https://url.pay97.cn/aB3/xY7k",
  "original_url": "https://example.com",
  "expire_at": 0,
  "expire_at_str": "永久"
}

在线测试

调用示例

下面示例中的 YOUR_KEY 替换为你的 API 密钥（从 后台「API 密钥」区域获取，格式 sk_xxx...）。

curl -X POST "https://url.pay97.cn/api.php?key=YOUR_KEY" \
  -d "url=https://example.com" \
  -d "expire=24"

// 在浏览器环境（已登录）可直接 fetch，session 自动带
const params = new URLSearchParams();
params.append('url', 'https://example.com');
params.append('expire', '24');

// 方式 A：带密钥（程序调用）
const res = await fetch('https://url.pay97.cn/api.php?key=YOUR_KEY', {
  method: 'POST',
  headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
  body: params.toString()
});
const data = await res.json();
console.log(data.short_url); // https://url.pay97.cn/{前缀}/{短码}

import requests

# 方式 A：带密钥（推荐）
resp = requests.post(
    'https://url.pay97.cn/api.php?key=YOUR_KEY',
    data={'url': 'https://example.com', 'expire': 24}
)
data = resp.json()
print(data['short_url'])  # https://url.pay97.cn/{前缀}/{短码}

# 方式 B：先登录拿 session 再调
session = requests.Session()
session.post('https://url.pay97.cn/api.php?action=login', data={'user': 'admin', 'pass': 'YOUR_KEY'})
resp = session.post('https://url.pay97.cn/api.php', data={'url': 'https://example.com'})
print(resp.json()['short_url'])

<?php
// 方式 A：带密钥（推荐）
$qs = http_build_query([
    'url'    => 'https://example.com',
    'expire' => 24,
]);
$json = file_get_contents(
    'https://url.pay97.cn/api.php?key=YOUR_KEY',
    false,
    stream_context_create(['http' => [
        'method'  => 'POST',
        'header'  => 'Content-Type: application/x-www-form-urlencoded',
        'content' => $qs,
    ]])
);
$data = json_decode($json, true);
echo $data['short_url']; // https://url.pay97.cn/{前缀}/{短码}

// 方式 B：先登录拿 cookie 再调
$cookie = tempnam(sys_get_temp_dir(), 'cookie');
$login = file_get_contents('https://url.pay97.cn/api.php?action=login', false,
    stream_context_create(['http' => ['method'=>'POST','header'=>'Content-Type: application/x-www-form-urlencoded','content'=>'user=admin&pass=YOUR_KEY','ignore_errors'=>true]])
);
// file_get_contents 不会自动存 cookie，更稳的方式是用 curl 句柄
echo $data['short_url'];

管理接口（需 API 密钥）

管理接口用于查询/删除短链记录，调用时必须带 key=你的API密钥。站长登录后可访问 管理后台 → 记录管理 网页管理。

1. 列出全部记录

{
  "success": true,
  "count": 2,
  "data": [
    {
      "code": "xY7k",
      "path_prefix": "aB3",
      "url": "https://example.com",
      "short_url": "https://url.pay97.cn/aB3/xY7k",
      "mode": "short",
      "expire_at": 0,
      "expire_at_str": "永久",
      "created_at": 1730000000,
      "created_at_str": "2026-10-28 12:00:00",
      "expired": false
    }
  ]
}

2. 删除一条短链

{ "success": true }