Biolinks

Les biolinks sont des pages d’atterrissage publiques de type « lien dans la bio ». Chaque page a un slug personnalisé, un nom d’affichage et une bio, un thème (prédéfini ou couleurs personnalisées), une liste de boutons (liens, réseaux sociaux, e-mail, téléphone, fichier, texte), une grille de publications/galerie et des analyses de vues et de clics. Cette page documente chaque commande biolink: exposée par la CLI.

Toutes les commandes acceptent les options globales : --json (par défaut) / --table pour le format de sortie, --verbose pour des erreurs détaillées, et --api-key <key> / --api-url <url> pour remplacer les identifiants à chaque appel. Aucune commande biolink: n’accepte d’options de pagination.

Base

biolink:list

Liste toutes les pages biolink de l’organisation authentifiée.

so-me biolink:list

Exemple

so-me biolink:list --table

biolink:get

Récupère tous les détails d’un biolink à partir de son ID interne.

so-me biolink:get <id>

Exemple

so-me biolink:get 550e8400-e29b-41d4-a716-446655440000

biolink:public

Affiche les données publiques d’un biolink à partir de son slug personnalisé. Cette commande résout la page comme le ferait un visiteur, elle n’exige donc pas l’UUID interne.

so-me biolink:public <slug>

Exemple

so-me biolink:public my-brand-page

biolink:create

Crée une nouvelle page biolink. Toutes les options sont facultatives.

so-me biolink:create [options]

Option	Description
`--slug <slug>`	Slug d’URL personnalisé (3 à 50 caractères alphanumériques)
`--name <name>`	Nom d’affichage
`--bio <bio>`	Texte de la bio

Exemple

so-me biolink:create --slug mypage --name "My Brand" --bio "Welcome to my page"

biolink:update

Met à jour une page biolink. Fournissez au moins une option, sinon la commande se termine avec une erreur.

so-me biolink:update <id> [options]

Option	Description
`--name <name>`	Nom d’affichage
`--bio <bio>`	Texte de la bio
`--slug <slug>`	Slug personnalisé
`--button-style <style>`	Style des boutons : `rounded`, `square`, `pill`, `outline`
`--show-grid`	Affiche la grille Instagram
`--hide-grid`	Masque la grille Instagram
`--social-icons <json>`	Icônes de réseaux sociaux sous forme de tableau JSON d’objets `{platform, url}`

--social-icons doit être un tableau JSON valide ; un JSON invalide met fin à la commande avec une erreur avant l’envoi de toute requête. --show-grid et --hide-grid définissent la visibilité de la grille Instagram (passez l’une des deux, pas les deux).

Exemples

# Rename and rewrite the bio
so-me biolink:update 550e8400-... --name "Acme Inc." --bio "Tools for makers"

# Switch button style and show the Instagram grid
so-me biolink:update 550e8400-... --button-style pill --show-grid

# Set social icons (escape the JSON for your shell)
so-me biolink:update 550e8400-... \
  --social-icons '[{"platform":"instagram","url":"https://instagram.com/acme"},{"platform":"x","url":"https://x.com/acme"}]'

biolink:delete

Supprime une page biolink. Une confirmation est demandée, sauf si -y/--yes est passé.

so-me biolink:delete <id> [options]

Option	Description
`-y, --yes`	Ignore la demande de confirmation

Exemple

so-me biolink:delete 550e8400-... --yes

biolink:publish

Bascule un biolink entre publié et non publié. La commande inverse l’état actuel de la page et indique le nouveau statut.

so-me biolink:publish <id>

Exemple

so-me biolink:publish 550e8400-...

Thème

biolink:theme

Modifie le thème d’un biolink à l’aide d’un thème prédéfini ou de couleurs personnalisées. Fournissez --preset, ou une ou plusieurs options de couleur personnalisée — n’en fournir aucune met fin à la commande avec une erreur. Si --preset est indiqué, il a priorité et les options de couleur personnalisée sont ignorées.

so-me biolink:theme <id> [options]

Option	Description
`--preset <theme>`	Thème prédéfini : `default`, `dark`, `gradient`, `minimal`, `neon`, `sunset`, `ocean`, `forest`
`--bg <color>`	Couleur d’arrière-plan personnalisée (hexadécimal)
`--text <color>`	Couleur de texte personnalisée (hexadécimal)
`--button <color>`	Couleur de bouton personnalisée (hexadécimal)
`--button-text <color>`	Couleur du texte des boutons personnalisée (hexadécimal)

Exemples

# Use a preset
so-me biolink:theme 550e8400-... --preset neon

# Custom colors
so-me biolink:theme 550e8400-... --bg "#1a1a2e" --text "#eaeaea" --button "#5417d7" --button-text "#ffffff"

Boutons

biolink:buttons — Lister les boutons

Liste tous les boutons d’un biolink.

so-me biolink:buttons <biolink-id>

Exemple

so-me biolink:buttons 550e8400-... --table

biolink:add-button — Ajouter un bouton

Ajoute un bouton à un biolink. --type et --text sont obligatoires ; les autres options dépendent du type de bouton.

so-me biolink:add-button <biolink-id> --type <type> --text <text> [options]

Option	Description
`--type <type>`	Type de bouton : `link`, `social`, `email`, `phone`, `file`, `text` (obligatoire)
`--text <text>`	Texte du bouton, 100 caractères max. (obligatoire)
`--url <url>`	URL (pour le type `link`/`social`)
`--email <email>`	E-mail (pour le type `email`)
`--phone <phone>`	Téléphone (pour le type `phone`)
`--file-url <url>`	URL du fichier (pour le type `file`)
`--content <content>`	Contenu (pour le type `text`)
`--icon <icon>`	Nom de l’icône
`--color <hex>`	Couleur de bouton personnalisée (hexadécimal)

Exemples

# Link button
so-me biolink:add-button 550e8400-... --type link --text "Visit Website" --url https://example.com

# Social button with an icon and custom color
so-me biolink:add-button 550e8400-... --type social --text "Follow on X" \
  --url https://x.com/acme --icon x --color "#000000"

# Email button
so-me biolink:add-button 550e8400-... --type email --text "Contact us" --email [email protected]

biolink:update-button — Modifier un bouton

Met à jour un bouton existant. Fournissez au moins une option, sinon la commande se termine avec une erreur.

so-me biolink:update-button <biolink-id> <button-id> [options]

Option	Description
`--text <text>`	Texte du bouton
`--url <url>`	URL
`--icon <icon>`	Icône
`--color <hex>`	Couleur personnalisée
`--active`	Définit comme actif
`--inactive`	Définit comme inactif

Exemple

so-me biolink:update-button 550e8400-... btn-123 --text "Shop now" --url https://example.com/shop --active

biolink:delete-button — Supprimer un bouton

Supprime un bouton. Une confirmation est demandée, sauf si -y/--yes est passé.

so-me biolink:delete-button <biolink-id> <button-id> [options]

Option	Description
`-y, --yes`	Ignore la demande de confirmation

Exemple

so-me biolink:delete-button 550e8400-... btn-123 --yes

biolink:reorder-buttons — Réorganiser les boutons

Réorganise les boutons d’un biolink. Passez les ID des boutons en arguments positionnels dans l’ordre d’affichage souhaité.

so-me biolink:reorder-buttons <biolink-id> <button-ids...>

Exemple

so-me biolink:reorder-buttons 550e8400-... btn-3 btn-1 btn-2

Galerie

biolink:posts — Lister les publications de la galerie

Liste les publications/éléments de la galerie d’un biolink.

so-me biolink:posts <biolink-id>

Exemple

so-me biolink:posts 550e8400-... --table

biolink:add-post — Ajouter une publication à la galerie

Ajoute une publication à la galerie. Toutes les options sont facultatives.

so-me biolink:add-post <biolink-id> [options]

Option	Description
`--image <url>`	URL de l’image
`--caption <text>`	Légende
`--link <url>`	URL du lien

Exemple

so-me biolink:add-post 550e8400-... \
  --image https://cdn.example.com/photo.jpg \
  --caption "Behind the scenes" \
  --link https://example.com/blog

biolink:update-post — Modifier une publication de la galerie

Met à jour une publication de la galerie. Fournissez au moins une option, sinon la commande se termine avec une erreur.

so-me biolink:update-post <biolink-id> <post-id> [options]

Option	Description
`--caption <text>`	Légende
`--link <url>`	URL du lien
`--visible`	Définit comme visible
`--hidden`	Définit comme masqué

Exemple

so-me biolink:update-post 550e8400-... post-123 --caption "Updated caption" --hidden

biolink:delete-post — Supprimer une publication de la galerie

Supprime une publication de la galerie. Une confirmation est demandée, sauf si -y/--yes est passé.

so-me biolink:delete-post <biolink-id> <post-id> [options]

Option	Description
`-y, --yes`	Ignore la demande de confirmation

Exemple

so-me biolink:delete-post 550e8400-... post-123 --yes

biolink:reorder-posts — Réorganiser les publications de la galerie

Réorganise les publications de la galerie. Passez les ID des publications en arguments positionnels dans l’ordre d’affichage souhaité.

so-me biolink:reorder-posts <biolink-id> <post-ids...>

Exemple

so-me biolink:reorder-posts 550e8400-... post-3 post-1 post-2

Analyses

biolink:analytics

Récupère les analyses d’un biolink, y compris les vues, les clics et le taux de clics (CTR).

so-me biolink:analytics <id>

Exemple

so-me biolink:analytics 550e8400-... --table

Premiers pas

Publication

AI Studio

Boîte de réception et engagement

Statistiques

Biolink

Équipe et collaboration

Paramètres et facturation

Webhooks

Assistance

Base

biolink:list

biolink:get

biolink:public

biolink:create

biolink:update

biolink:delete

biolink:publish

Thème

biolink:theme

Boutons

Galerie

Analyses

biolink:analytics

​Base

​biolink:list

​biolink:get

​biolink:public

​biolink:create

​biolink:update

​biolink:delete

​biolink:publish

​Thème

​biolink:theme

​Boutons

​Galerie

​Analyses

​biolink:analytics

Base

biolink:list

biolink:get

biolink:public

biolink:create

biolink:update

biolink:delete

biolink:publish

Thème

biolink:theme

Boutons

Galerie

Analyses

biolink:analytics