0BLA / LES GUIDES
Une tâche. Une réponse.
Du premier lien à son intégration. Choisissez ce que vous voulez faire, suivez les étapes et retrouvez les réglages dans votre espace.
01 · Créer un lien
Un lien court garde la destination que vous avez choisie : une page, un document ou un profil déjà en ligne.
- Connectez-vous avant de créer le lien pour le retrouver ensuite dans votre tableau de bord.
- Collez l’adresse complète de la destination dans le formulaire. L’alias est facultatif : laissez-le vide pour obtenir une adresse automatiquement.
- Choisissez « Raccourcir ». Attendez le résultat de création, puis copiez l’adresse courte affichée ou récupérez son QR code.
- Ouvrez votre lien pour vérifier la destination avant de le diffuser. Ce contrôle peut ajouter un clic à son compteur.
Sans compte : cinq minutes. Un lien créé sans connexion expire après cinq minutes. Pour l’installer sur un site, créez-le depuis votre compte et vérifiez sa durée.
Si un alias est déjà pris, choisissez-en un autre. Si une limite est atteinte, consultez les liens de votre compte et les conditions de votre offre. Les options de durée et de nombre maximal de clics sont accessibles à partir de Pro.
Créer plusieurs liens
Avec Business ou Enterprise, ouvrez « En masse » dans le dashboard. Collez une URL complète par ligne, lancez la création, puis vérifiez le résultat de chaque ligne. Une erreur sur une adresse demande de corriger cette adresse avant de réessayer.
Travailler avec une équipe
Avec Business ou Enterprise, vous pouvez inviter deux collaborateurs dans « Équipe ». Ils pourront consulter et modifier vos liens, y compris leurs destinations et leurs limites. Vous conservez la suppression des liens. L’offre personnelle de chaque membre reste inchangée.
- Vérifiez l’adresse email, puis choisissez « Inviter ». L’invitation reste en attente, même si cette personne possède déjà un compte.
- Le destinataire ouvre le lien reçu par email. Il se connecte avec la même adresse, ou crée son compte et vérifie son email, puis choisit « Accepter l’invitation » dans Équipe.
- Le lien est valable sept jours. « Renvoyer » crée un nouveau lien et invalide le précédent. « Annuler l’invitation » empêche son acceptation. Si l’envoi n’est pas confirmé, l’invitation reste visible et peut être renvoyée après une minute.
Vos propres appartenances sont affichées séparément. Vous pouvez quitter une équipe depuis cette rubrique, même si votre compte est gratuit. Les liens partagés par une équipe sont accessibles tant que l’appartenance et l’offre du propriétaire le permettent.
Retirer un membre ou quitter une équipe révoque l’accès aux liens partagés. Un compte propriétaire suspendu ou une offre qui ne permet plus le partage suspend aussi cet accès. Les liens restent la propriété de leur créateur.
Retrouver les réglages de mon compte
La page Profil regroupe votre image, votre offre et votre abonnement, le changement de mot de passe et les clés API. « Retour aux liens » vous ramène au dashboard. Les actions de suppression et de résiliation sont présentées séparément des réglages courants.
02 · Placer le lien sur un site
Remplacez la destination de votre bouton par le lien court créé dans 0bla. Le texte du bouton et la page d’arrivée restent les mêmes.
- Copiez le lien depuis votre tableau de bord.
- Dans votre éditeur de site, collez-le dans le champ « Lien » du bouton. En HTML, remplacez la valeur de href.
- Enregistrez la page, puis vérifiez le bouton sur ordinateur et sur mobile.
<a href="VOTRE_LIEN_COURT"> Découvrir mon projet </a>
Remplacez VOTRE_LIEN_COURT par l’adresse obtenue dans 0bla et adaptez le texte au contenu. Le même principe s’applique à un profil LinkedIn, un document ou une page produit.
Sur papier
L’action QR code du tableau de bord représente le même lien court. Avant impression, testez le scan et vérifiez que la durée du lien couvre celle du support.
Utiliser mon propre domaine
Avec Business ou Enterprise, l’onglet Domaines permet d’ajouter un domaine personnalisé. Suivez les indications DNS affichées dans cet onglet, puis vérifiez le domaine avant de l’utiliser pour créer des liens.
Deux enregistrements sont fournis pour chaque nouveau domaine : un CNAME vers le service et un TXT propre à votre domaine pour en confirmer le contrôle. Recopiez les noms et valeurs affichés, conservez le TXT, puis utilisez Vérifier le domaine après propagation. Un refus de configuration laisse le domaine en attente et affiche la prochaine action.
03 · Interpréter les clics
Dans votre tableau de bord, choisissez « Statistiques » sur la ligne du lien concerné. Vous consultez les données de ce lien dans votre compte.
Un compteur de clics n’est pas un nombre exact de personnes. Plusieurs ouvertures, des robots ou des aperçus automatiques peuvent solliciter le même lien. Un clic ne prouve ni la lecture d’un document, ni un achat.
- Clics
- Le nombre de sollicitations enregistrées pour le lien. Un lien sans activité affiche zéro.
- Statistiques avancées
- À partir de Pro : séries par jour, pays, appareils et navigateurs pour observer des tendances.
- Export CSV
- À partir de Pro : téléchargez les statistiques depuis votre espace pour les analyser dans votre outil.
Le graphique de la page d’accueil illustre la présentation des statistiques. Les compteurs du tableau de bord proviennent de vos liens.
04 · Utiliser l’API existante
Pour créer des liens depuis un programme, utilisez l’API externe avec une clé API. Cet accès est disponible avec Business et Enterprise.
- Dans votre profil, créez une clé API et conservez-la dans la configuration privée de votre serveur.
- Envoyez une requête POST avec le champ url et l’en-tête Authorization: Bearer. Le champ alias est facultatif.
- Vérifiez le statut HTTP et status dans la réponse. Utilisez short_url seulement après un succès ; une création réussie renvoie HTTP 201.
POST https://0bla.com/api/external-create.php
Authorization: Bearer VOTRE_CLE_API
Content-Type: application/json
{"url":"https://example.com"}
Une clé incorrecte ou révoquée est refusée. Le compte doit être actif et son offre doit toujours inclure l’API. La limite actuelle est de 100 créations par heure et par clé ; une limite atteinte renvoie HTTP 429.
Gardez votre clé côté serveur. Ne la placez pas dans le HTML, le JavaScript public ou l’adresse d’un lien. Révoquez une clé exposée depuis votre profil.
Les opérations du tableau de bord utilisent un autre accès : la session du compte et son jeton CSRF. Leur référence couvre la création, l’édition, la suppression, les statistiques et l’export ; elle ne s’authentifie pas avec la clé Bearer ci-dessus.
05 · Configurer un webhook
Un webhook transmet un événement à votre outil quand un lien est utilisé. Les webhooks de 0bla sont disponibles avec Business et Enterprise.
- Préparez un point de réception HTTPS public sur votre serveur ou dans votre outil. Les adresses internes et les redirections sont refusées.
- Ouvrez l’onglet Webhooks du tableau de bord. Renseignez un nom explicite et l’adresse de réception, puis ajoutez le webhook.
- Pour un récepteur personnalisé, conservez son secret et vérifiez la signature avant de traiter les données. Consultez le format exact dans la référence.
- Vérifiez une réception sur un lien de test que vous contrôlez, puis le traitement par votre outil. La présence du webhook dans la liste ne suffit pas à confirmer sa réception.
- Événement
link_click· Clic sur un lien du compte.- Configuration
- Jusqu’à cinq webhooks par compte. Vous pouvez activer, désactiver ou supprimer un webhook depuis sa ligne.
- Réception
- L’envoi actuel effectue une tentative, avec un délai maximal de deux secondes. Aucun rejeu automatique n’est prévu ; votre récepteur doit répondre rapidement.
Les connecteurs Slack, Discord et Mattermost adaptent la présentation du message. Pour un récepteur personnalisé, la référence décrit le JSON 0bla et les en-têtes de signature.
06 · Comprendre un problème de redirection
Commencez par vérifier l’adresse courte complète et le message affiché. Le lien, sa durée et la destination sont trois points distincts à contrôler.
- Lien introuvable · 404
- Recopiez le lien depuis votre tableau de bord. Vérifiez l’alias, le domaine utilisé et une éventuelle suppression.
- Lien expiré · 410
- La date d’expiration est passée. Les liens créés sans compte durent cinq minutes. Depuis votre compte, vérifiez la durée du lien et les options de votre offre.
- Limite de clics atteinte · 403
- Le nombre maximal de clics du lien a été atteint. Si vous gérez ce lien, consultez ses réglages ; sinon, contactez son auteur.
- Mot de passe demandé
- Utilisez le mot de passe du lien communiqué par son auteur. Il ne s’agit pas du mot de passe de votre compte 0bla.
- Destination différente sur mobile
- Vérifiez les destinations iOS et Android configurées dans l’édition du lien. Sans règle pour l’appareil, la destination principale est utilisée.
Si le lien redirige correctement mais que la page d’arrivée est indisponible, le problème est sur la destination. Pour un domaine personnalisé, vérifiez également son état et sa configuration DNS dans votre espace.