MGly - Reducteur d'URL

Documentation API

Intégrez MGly dans vos applications pour créer et gérer des liens courts.

OpenAPI SpecAI Skill Filellms.txt

Démarrage rapide

1. Créez un compte sur mgly.fr
2. Générez une clé API sur /dashboard/api-keys
3. Utilisez la clé dans vos requêtes

curl
curl -X POST https://mgly.fr/api/v1/links \
  -H "Authorization: Bearer mgly_votre_cle" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/mon-article", "name": "Mon article"}'

Authentification

Toutes les requêtes API nécessitent une clé API dans le header Authorization.

Authorization: Bearer mgly_xxxxxxxxxxxxxxxxxxxxxxxxxxxx

La clé est affichée une seule fois à la création. Conservez-la précieusement. Seul le hash SHA-256 est stocké côté serveur.

Vue d'ensemble des endpoints

POST/api/v1/links— Créer un lien court
GET/api/v1/links— Lister ses liens
GET/api/v1/links/:id— Détail d'un lien
PUT/api/v1/links/:id— Modifier un lien
DELETE/api/v1/links/:id— Supprimer un lien
GET/api/v1/links/:id/qrcode— QR code d'un lien

Créer un lien

curl
curl -X POST https://mgly.fr/api/v1/links \
  -H "Authorization: Bearer mgly_xxx" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "name": "Mon lien"}'
JavaScript (fetch)
const res = await fetch('https://mgly.fr/api/v1/links', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer mgly_xxx',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ url: 'https://example.com', name: 'Mon lien' }),
});
const data = await res.json();
console.log(data.link.shortUrl); // https://mgly.fr/l/xK9mPq
Python (requests)
import requests

res = requests.post('https://mgly.fr/api/v1/links',
    headers={'Authorization': 'Bearer mgly_xxx'},
    json={'url': 'https://example.com', 'name': 'Mon lien'})
data = res.json()
print(data['link']['shortUrl'])  # https://mgly.fr/l/xK9mPq
Réponse
{
  "success": true,
  "link": {
    "id": "abc123",
    "slug": "xK9mPq",
    "url": "https://example.com",
    "shortUrl": "https://mgly.fr/l/xK9mPq",
    "name": "Mon lien",
    "active": true,
    "createdAt": "2026-01-01T00:00:00.000Z"
  }
}

Lister les liens

Paramètres query : page, limit (max 100), search

curl
curl https://mgly.fr/api/v1/links?page=1&limit=10 \
  -H "Authorization: Bearer mgly_xxx"

Détail d'un lien

curl
curl https://mgly.fr/api/v1/links/abc123 \
  -H "Authorization: Bearer mgly_xxx"

Modifier un lien

Seuls url et name sont modifiables. Le slug est immutable via l'API publique.

curl
curl -X PUT https://mgly.fr/api/v1/links/abc123 \
  -H "Authorization: Bearer mgly_xxx" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://new-url.com", "name": "Nouveau nom"}'

Supprimer un lien

curl
curl -X DELETE https://mgly.fr/api/v1/links/abc123 \
  -H "Authorization: Bearer mgly_xxx"

QR Code

Générez un QR code pour n'importe quel lien. Personnalisable en couleurs, taille et format.

ParamètreDéfautDescription
formatpngpng ou svg
size300100 à 2000 pixels
fg000000Couleur QR (hex sans #)
bgFFFFFFCouleur fond (hex sans #)
curl
# PNG 500px avec QR bleu sur fond blanc
curl -o qrcode.png "https://mgly.fr/api/v1/links/abc123/qrcode?format=png&size=500&fg=1e40af&bg=FFFFFF" \
  -H "Authorization: Bearer mgly_xxx"

# SVG
curl -o qrcode.svg "https://mgly.fr/api/v1/links/abc123/qrcode?format=svg" \
  -H "Authorization: Bearer mgly_xxx"

Codes d'erreur

CodeSignification
400Requête invalide (URL invalide, champs manquants)
401Clé API manquante ou invalide
403Interdit (lien ou compte désactivé)
404Lien non trouvé
409Conflit (URL déjà raccourcie, collision de slug)
429Rate limit dépassé
500Erreur serveur
Format d'erreur
{
  "error": "Message d'erreur lisible"
}

Rate limiting

Chaque clé API est limitée à 100 requêtes par heure. En cas de dépassement, l'API retourne une erreur 429. Le compteur se réinitialise après 1 heure.

Intégration avec des agents IA

MGly est conçu pour être facilement intégrable par des agents IA (Claude, GPT, OpenClaw, etc.). Plusieurs fichiers standardisés sont disponibles pour permettre aux agents de découvrir et utiliser l'API automatiquement.

Fichiers disponibles

/skill.mdRecommandé pour les agents IA

Instructions complètes au format Skill : authentification, endpoints, exemples de requêtes/réponses, bonnes pratiques. Compatible avec les agents comme OpenClaw, Moltbook, et tout agent supportant le format skill.md.

/llms.txt

Résumé concis au format llms.txt. Idéal pour les LLMs qui scannent les sites pour découvrir des APIs.

/openapi.json

Spécification OpenAPI 3.1 complète. Compatible avec Swagger UI, Postman, et tout outil supportant OpenAPI.

Exemple d'utilisation par un agent

Un agent IA peut utiliser l'API MGly pour raccourcir des liens au nom de son utilisateur. Voici un exemple de workflow typique :

Workflow agent IA
# 1. L'utilisateur fournit sa clé API MGly à l'agent
API_KEY="mgly_xxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# 2. L'agent crée un lien court
curl -X POST https://mgly.fr/api/v1/links \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/long-article", "name": "Article partagé via agent"}'

# 3. L'agent récupère le QR code si nécessaire
curl -o qrcode.png "https://mgly.fr/api/v1/links/{id}/qrcode?size=500" \
  -H "Authorization: Bearer $API_KEY"

# 4. L'agent retourne le lien court et/ou le QR code à l'utilisateur

Bonnes pratiques pour les agents

  • Ne stockez jamais la clé API en clair dans vos logs ou réponses
  • Gérez les erreurs 429 (rate limit) avec un backoff exponentiel
  • Utilisez le champ name pour identifier l'origine du lien
  • Préférez le format SVG pour les QR codes intégrés dans des documents
  • Vérifiez toujours le champ success dans les réponses
🤖

Vous utilisez un agent IA ?

Envoyez ce message à votre agent (Claude, GPT, OpenClaw, etc.) :

Lis https://mgly.fr/skill.md et utilise l'API MGly pour raccourcir mes liens.

1. Copiez le texte ci-dessus et envoyez-le à votre agent IA

2. Créez une clé API sur /dashboard/api-keys

3. Fournissez la clé à votre agent quand il la demande

Créer un compteVoir skill.md