Documentation API

🔗 1. Raccourcir une URL

Endpoint : GET /api.php?api_shorten

🛠️ Paramètres GET

url (requis) – L’URL à raccourcir
custom_code (optionnel) – Code personnalisé souhaité
private (optionnel) – 1 pour créer un lien privé
Balises UTM optionnelles :
- utm_source, utm_medium, utm_campaign, utm_term, utm_content

✅ Réponse attendue

{
  "success": true,
  "short_url": "https://sgo.li/demo123",
  "private_stats_url": "https://sgo.li/advanced-stats.php?hash=abc-xyz",
  "hash": "abc-xyz",
  "code": "demo123"
}

📈 2. Statistiques simples

Endpoint : GET /api.php?stats=CODE

🛠️ Paramètres optionnels

hash (string, requis si lien privé)

⚠️ Accès sécurisé si lien privé

Si le lien est privé, vous devez également passer le paramètre hash correspondant, sinon l'accès sera refusé.

📦 Exemple de réponse

{
  "id": 456,
  "long_url": "https://example.com",
  "short_code": "demo123",
  "created_at": "2025-05-21",
  "clicks": 112
}

📊 3. Statistiques avancées

Endpoint : GET /api.php?stats_full=CODE

🛠️ Paramètres

hash (string, requis si le lien est privé)

📦 Exemple de réponse

{
  "url": {
    "long_url": "https://example.com",
    "created_at": "2025-05-20",
    "clicks": 112
  },
  "utm": {
    "utm_source": "newsletter",
    "utm_campaign": "mai2025"
  },
  "clicks_by_day": [
    { "date": "2025-05-20", "total": 43 }
  ],
  "logs": [
    {
      "clicked_at": "2025-05-20 16:01",
      "country": "FR",
      "browser": "Chrome",
      "device_type": "Desktop",
      "language": "fr-FR"
    }
  ]
}

🔐 4. Statistiques privées

Endpoint : GET /api.php?stats_private=HASH

Permet de consulter les stats uniquement avec le hash généré pour un lien privé.

📦 Exemple de réponse

{
  "url": {
    "long_url": "https://example.com",
    "short_code": "demo123",
    "clicks": 42
  },
  "clicks_by_day": [
    { "date": "2025-05-20", "total": 8 }
  ],
  "logs": [
    {
      "clicked_at": "2025-05-20 16:12",
      "country": "FR",
      "device_type": "Mobile"
    }
  ]
}