Documentation API v1

Prend en charge la génération d’un lien unique, la génération par lot, les liens courts Mini App et la génération de QR code.

Présentation de l’API
  • Adresse de l’API：https://suo.run/api/v1
  • Méthode de requête：POST
  • Type de contenu：application/json
  • Format de réponse：code / msg / data
  • Authentification：API Key （ Créer une clé API ）
Exemple d’en-têtes
Content-Type: application/json
X-API-Key: Votre clé API
POST /api/v1/generate Générer un lien court
Description des paramètres
Paramètre Description
url Lien original
expire Jours de validité
custom_code Code court personnalisé
password Mot de passe d’accès
ua_stay Stratégie de plateforme d’accès
ua_plan Liste blanche des plateformes d’accès
site_id ID de configuration de domaine court
Exemple de requête
{
  "url": "https://example.com",
  "expire": 7,
  "custom_code": "",
  "password": "",
  "ua_stay": 0,
  "ua_plan": ["IOS","Android","PC","other"],
  "site_id": 1
}
Exemple de réponse
{
  "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 Génération par lot
Description des paramètres
Paramètre Description
urls Liste d’URL (max 100)
expire Jours de validité
password Mot de passe d’accès
ua_stay Stratégie de plateforme d’accès
ua_plan Liste blanche des plateformes d’accès
site_id ID de configuration de domaine court
Exemple de requête
{
  "urls": [
    "https://example.com/a",
    "https://example.com/b"
  ],
  "expire": 7,
  "password": "",
  "ua_stay": 0,
  "ua_plan": ["IOS","Android","PC","other"],
  "site_id": 1
}
Exemple de réponse
{
  "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 Lien court Mini App
Description des paramètres
Paramètre Description
appid AppID Mini App
appsecret AppSecret Mini App
page Chemin de page Mini App (prend en charge ?query)
expire Jours de validité
custom_code Code court personnalisé
password Mot de passe d’accès
ua_stay Stratégie de plateforme d’accès
ua_plan Liste blanche des plateformes d’accès
site_id ID de configuration de domaine court
Exemple de requête
{
  "appid": "AppID Mini App",
  "appsecret": "AppSecret Mini App",
  "page": "pages/index",
  "expire": 7,
  "custom_code": "",
  "password": "",
  "ua_stay": 0,
  "ua_plan": ["IOS","Android","PC","other"],
  "site_id": 1
}
Exemple de réponse
{
  "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 Génération de QR code
Description des paramètres
Paramètre Description
url Lien original
expire Jours de validité
custom_code Code court personnalisé
password Mot de passe d’accès
ua_stay Stratégie de plateforme d’accès
ua_plan Liste blanche des plateformes d’accès
site_id ID de configuration de domaine court
Exemple de requête
{
  "url": "https://example.com",
  "expire": 7,
  "custom_code": "",
  "password": "",
  "ua_stay": 0,
  "ua_plan": ["IOS","Android","PC","other"],
  "site_id": 1
}
Exemple de réponse
{
  "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"
  }
}