Liens courts pour SaaS : intégrez URLW dans votre produit via API

Les produits SaaS modernes génèrent quotidiennement des URLs à partager : invitations d'équipe, partages de documents, liens de téléchargement, pages de statut... Intégrer un raccourcisseur d'URL directement dans votre SaaS améliore l'expérience utilisateur et vous donne une visibilité précieuse sur les comportements de partage. L'API URLW rend cette intégration rapide et fiable.

Pourquoi les SaaS bénéficient des liens courts

L'intégration d'un raccourcisseur d'URL dans un SaaS répond à plusieurs cas d'usage concrets :

• Liens d'invitation : « Invitez un collègue » génère un lien court personnalisé avec le prénom de l'invitant et un token d'invitation — lisible, partageable par SMS ou email
• Partage de contenu : vos utilisateurs partagent des rapports, tableaux de bord ou documents. Un lien court go.votre-saas.com/rapport-xyz est bien plus pro que l'URL interne de votre app
• Téléchargements et exports : les liens de téléchargement temporaires sont souvent longs et complexes. Un lien court avec expiration est plus rassurant pour l'utilisateur
• Notifications et emails transactionnels : les liens dans vos emails de notification (confirmation, reset password, etc.) peuvent bénéficier d'un domaine cohérent avec votre marque
• Analytics sur les partages : mesurez combien de liens générés par vos utilisateurs sont effectivement cliqués — une métrique d'engagement précieuse

Intégrer l'API URLW dans votre SaaS

Voici un exemple d'intégration pour générer automatiquement un lien court lors d'un partage de rapport :

curl -X POST https://urlw.fr/api/v1/links \
-H "Authorization: Bearer VOTRE_CLE_API" \
-H "Content-Type: application/json" \
-d '{
"url": "https://app.votre-saas.com/rapports/rpt_a1b2c3?token=eyJhbGc...",
"slug": "rapport-juin-equipe-acme",
"domain": "share.votre-saas.com",
"expires_at": "2025-07-31T23:59:59Z",
"metadata": {
  "user_id": "usr_456",
  "report_id": "rpt_a1b2c3",
  "workspace": "acme-corp"
}
}'

Le champ metadata vous permet de stocker des identifiants internes qui vous permettront de relier chaque clic URLW à un utilisateur et un objet spécifique dans votre base de données.

Webhooks URLW pour les notifications en temps réel

Plutôt que de poller l'API URLW pour détecter de nouveaux clics, configurez des webhooks pour recevoir une notification HTTP en temps réel à chaque événement :

• Événement link.clicked : reçu à chaque clic sur un lien. Contient l'ID du lien, la date/heure, le pays et le type d'appareil.
• Événement link.expired : notifie quand un lien atteint sa date d'expiration ou son nombre de clics maximum.
• Événement link.created : utile pour synchroniser les liens créés via l'interface URLW (par un opérateur) avec votre base de données.

Configuration du webhook dans URLW :

curl -X POST https://urlw.fr/api/v1/webhooks \
-H "Authorization: Bearer VOTRE_CLE_API" \
-H "Content-Type: application/json" \
-d '{
"url": "https://app.votre-saas.com/webhooks/urlw",
"events": ["link.clicked", "link.expired"],
"secret": "votre_secret_webhook_pour_verifier_la_signature"
}'

Bonnes pratiques d'intégration SaaS

• Utilisez un domaine dédié pour vos partages : share.votre-saas.com ou go.votre-saas.com renforce votre identité de marque à chaque partage
• Créez les liens de manière asynchrone : ne bloquez jamais votre UI en attendant la réponse de l'API URLW. Créez le lien en background et renvoyez-le à l'utilisateur dès qu'il est disponible
• Gérez les expirations côté métier : définissez des durées de validité cohérentes avec votre logique applicative (ex. : lien d'invitation valable 7 jours)
• Stockez l'ID URLW dans votre base de données : conservez l'ID du lien URLW avec l'objet associé pour pouvoir interroger les stats ou supprimer le lien en cas de besoin
• Testez la résilience : que se passe-t-il si l'API URLW est temporairement indisponible ? Votre app doit gracefully fallback sur l'URL complète

Consultez la documentation complète de l'API URLW et les plans tarifaires pour SaaS. Créez votre compte pour commencer l'intégration.