Documentación API v1

Admite generación de enlace único, generación por lotes, enlaces cortos de Mini App y generación de código QR.

Descripción de la interfaz
  • Dirección del API：https://suo.run/api/v1
  • Método de solicitud：POST
  • Tipo de contenido：application/json
  • Formato de respuesta：code / msg / data
  • Método de autenticación：API Key （ Crear clave API ）
Encabezados de ejemplo
Content-Type: application/json
X-API-Key: Tu clave API
POST /api/v1/generate Generar enlace corto
Descripción de parámetros
Parámetro Descripción
url Enlace original
expire Días de validez
custom_code Código corto personalizado
password Contraseña de acceso
ua_stay Política de plataforma de acceso
ua_plan Lista blanca de plataformas de acceso
site_id ID de configuración de dominio corto
Solicitud de ejemplo
{
  "url": "https://example.com",
  "expire": 7,
  "custom_code": "",
  "password": "",
  "ua_stay": 0,
  "ua_plan": ["IOS","Android","PC","other"],
  "site_id": 1
}
Respuesta de ejemplo
{
  "code": 1,
  "msg": "success",
  "data": {
    "original_url": "https://example.com",
    "short_url": "http://j58s.298.run",
    "short_code": "j58s",
    "expire_time": "2026-02-13 00:15:25",
    "site_url": "j58s.298.run"
  }
}
POST /api/v1/batchGenerate Generación por lotes
Descripción de parámetros
Parámetro Descripción
urls Lista de URL (máx. 100)
expire Días de validez
password Contraseña de acceso
ua_stay Política de plataforma de acceso
ua_plan Lista blanca de plataformas de acceso
site_id ID de configuración de dominio corto
Solicitud de ejemplo
{
  "urls": [
    "https://example.com/a",
    "https://example.com/b"
  ],
  "expire": 7,
  "password": "",
  "ua_stay": 0,
  "ua_plan": ["IOS","Android","PC","other"],
  "site_id": 1
}
Respuesta de ejemplo
{
  "code": 1,
  "msg": "success",
  "data": {
    "results": [
      {
        "original_url": "https://example.com/a",
        "short_url": "http://bf63sr.298.run",
        "site_url": "bf63sr.298.run"
      },
      {
        "original_url": "https://example.com/b",
        "short_url": "http://3yj2oy.298.run",
        "site_url": "3yj2oy.298.run"
      }
    ],
    "expire_time": "2026-02-13 00:05:11",
    "errors": [],
    "total": 2,
    "success_count": 2,
    "error_count": 0
  }
}
POST /api/v1/miniApp Enlace corto Mini App
Descripción de parámetros
Parámetro Descripción
appid AppID de Mini App
appsecret AppSecret de Mini App
page Ruta de página de Mini App (admite ?query)
expire Días de validez
custom_code Código corto personalizado
password Contraseña de acceso
ua_stay Política de plataforma de acceso
ua_plan Lista blanca de plataformas de acceso
site_id ID de configuración de dominio corto
Solicitud de ejemplo
{
  "appid": "AppID de Mini App",
  "appsecret": "AppSecret de Mini App",
  "page": "pages/index",
  "expire": 7,
  "custom_code": "",
  "password": "",
  "ua_stay": 0,
  "ua_plan": ["IOS","Android","PC","other"],
  "site_id": 1
}
Respuesta de ejemplo
{
  "code": 1,
  "msg": "success",
  "data": {
    "original_url": "weixin://dl/business/?t=Sctv5oaz0Id",
    "short_url": "http://vmei.298.run",
    "short_code": "vmei",
    "expire_time": "2026-02-13 00:15:31",
    "site_url": "vmei.298.run"
  }
}
POST /api/v1/qcodeGenerate Generación de código QR
Descripción de parámetros
Parámetro Descripción
url Enlace original
expire Días de validez
custom_code Código corto personalizado
password Contraseña de acceso
ua_stay Política de plataforma de acceso
ua_plan Lista blanca de plataformas de acceso
site_id ID de configuración de dominio corto
Solicitud de ejemplo
{
  "url": "https://example.com",
  "expire": 7,
  "custom_code": "",
  "password": "",
  "ua_stay": 0,
  "ua_plan": ["IOS","Android","PC","other"],
  "site_id": 1
}
Respuesta de ejemplo
{
  "code": 1,
  "msg": "success",
  "data": {
    "original_url": "https://example.com",
    "short_url": "http://8fw6.298.run",
    "short_code": "8fw6",
    "expire_time": "2026-02-13 00:15:32",
    "site_url": "8fw6.298.run",
    "qr_url": "https://api.qrserver.com/v1/create-qr-code/?size=300x300&data=http%3A%2F%2F8fw6.298.run"
  }
}