Biolinks

Biolinks sind öffentliche Link-in-Bio-Landingpages. Jede Seite hat einen eigenen Slug, einen Anzeigenamen und eine Bio, ein Design (Voreinstellung oder eigene Farben), eine Liste von Schaltflächen (Link, Social, E-Mail, Telefon, Datei, Text), ein Beitrags-/Galerieraster sowie Aufruf- und Klick-Analysen. Diese Seite dokumentiert jeden biolink:-Befehl der CLI.

Alle Befehle akzeptieren die globalen Flags: --json (Standard) / --table für das Ausgabeformat, --verbose für detaillierte Fehler sowie --api-key <key> / --api-url <url>, um Zugangsdaten pro Aufruf zu überschreiben. Keiner der biolink:-Befehle akzeptiert Paginierungs-Flags.

Kernbefehle

biolink:list

Listet alle Biolink-Seiten der authentifizierten Organisation auf.

so-me biolink:list

Beispiel

so-me biolink:list --table

biolink:get

Ruft alle Details eines einzelnen Biolinks über seine interne ID ab.

so-me biolink:get <id>

Beispiel

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

biolink:public

Zeigt öffentliche Biolink-Daten über den eigenen Slug an. Dieser Befehl löst die Seite genauso auf wie ein Besucher, daher ist die interne UUID nicht nötig.

so-me biolink:public <slug>

Beispiel

so-me biolink:public my-brand-page

biolink:create

Erstellt eine neue Biolink-Seite. Alle Optionen sind optional.

so-me biolink:create [options]

Option	Beschreibung
`--slug <slug>`	Eigener URL-Slug (3–50 alphanumerische Zeichen)
`--name <name>`	Anzeigename
`--bio <bio>`	Bio-Text

Beispiel

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

biolink:update

Aktualisiert eine Biolink-Seite. Gib mindestens eine Option an, sonst beendet sich der Befehl mit einem Fehler.

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

Option	Beschreibung
`--name <name>`	Anzeigename
`--bio <bio>`	Bio-Text
`--slug <slug>`	Eigener Slug
`--button-style <style>`	Schaltflächenstil: `rounded`, `square`, `pill`, `outline`
`--show-grid`	Instagram-Raster anzeigen
`--hide-grid`	Instagram-Raster ausblenden
`--social-icons <json>`	Social-Icons als JSON-Array von `{platform, url}`-Objekten

--social-icons muss ein gültiges JSON-Array sein; bei ungültigem JSON beendet sich der Befehl mit einem Fehler, bevor eine Anfrage gestellt wird. --show-grid und --hide-grid legen die Sichtbarkeit des Instagram-Rasters fest (gib eines an, nicht beide).

Beispiele

# Umbenennen und die Bio neu schreiben
so-me biolink:update 550e8400-... --name "Acme Inc." --bio "Tools for makers"

# Schaltflächenstil wechseln und das Instagram-Raster anzeigen
so-me biolink:update 550e8400-... --button-style pill --show-grid

# Social-Icons setzen (JSON für deine Shell maskieren)
so-me biolink:update 550e8400-... \
  --social-icons '[{"platform":"instagram","url":"https://instagram.com/acme"},{"platform":"x","url":"https://x.com/acme"}]'

biolink:delete

Löscht eine Biolink-Seite. Fragt nach einer Bestätigung, sofern nicht -y/--yes übergeben wird.

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

Option	Beschreibung
`-y, --yes`	Bestätigungsabfrage überspringen

Beispiel

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

biolink:publish

Schaltet einen Biolink zwischen veröffentlicht und nicht veröffentlicht um. Der Befehl wechselt den jeweils aktuellen Zustand der Seite und meldet den neuen Status.

so-me biolink:publish <id>

Beispiel

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

Design

biolink:theme

Ändert das Design eines Biolinks entweder über eine Voreinstellung oder eigene Farben. Gib --preset oder eine bzw. mehrere eigene Farboptionen an — fehlt beides, beendet sich der Befehl mit einem Fehler. Ist --preset angegeben, hat es Vorrang, und die eigenen Farboptionen werden ignoriert.

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

Option	Beschreibung
`--preset <theme>`	Voreingestelltes Design: `default`, `dark`, `gradient`, `minimal`, `neon`, `sunset`, `ocean`, `forest`
`--bg <color>`	Eigene Hintergrundfarbe (Hex)
`--text <color>`	Eigene Textfarbe (Hex)
`--button <color>`	Eigene Schaltflächenfarbe (Hex)
`--button-text <color>`	Eigene Schaltflächentextfarbe (Hex)

Beispiele

# Eine Voreinstellung verwenden
so-me biolink:theme 550e8400-... --preset neon

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

Schaltflächen

biolink:buttons — Schaltflächen auflisten

Listet alle Schaltflächen eines Biolinks auf.

so-me biolink:buttons <biolink-id>

Beispiel

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

biolink:add-button — Eine Schaltfläche hinzufügen

Fügt einem Biolink eine Schaltfläche hinzu. --type und --text sind erforderlich; die übrigen Optionen hängen vom Schaltflächentyp ab.

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

Option	Beschreibung
`--type <type>`	Schaltflächentyp: `link`, `social`, `email`, `phone`, `file`, `text` (erforderlich)
`--text <text>`	Schaltflächentext, max. 100 Zeichen (erforderlich)
`--url <url>`	URL (für den Typ `link`/`social`)
`--email <email>`	E-Mail-Adresse (für den Typ `email`)
`--phone <phone>`	Telefonnummer (für den Typ `phone`)
`--file-url <url>`	Datei-URL (für den Typ `file`)
`--content <content>`	Inhalt (für den Typ `text`)
`--icon <icon>`	Icon-Name
`--color <hex>`	Eigene Schaltflächenfarbe (Hex)

Beispiele

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

# Social-Schaltfläche mit Icon und eigener Farbe
so-me biolink:add-button 550e8400-... --type social --text "Follow on X" \
  --url https://x.com/acme --icon x --color "#000000"

# E-Mail-Schaltfläche
so-me biolink:add-button 550e8400-... --type email --text "Contact us" --email [email protected]

biolink:update-button — Eine Schaltfläche aktualisieren

Aktualisiert eine bestehende Schaltfläche. Gib mindestens eine Option an, sonst beendet sich der Befehl mit einem Fehler.

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

Option	Beschreibung
`--text <text>`	Schaltflächentext
`--url <url>`	URL
`--icon <icon>`	Icon
`--color <hex>`	Eigene Farbe
`--active`	Auf aktiv setzen
`--inactive`	Auf inaktiv setzen

Beispiel

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

biolink:delete-button — Eine Schaltfläche löschen

Löscht eine Schaltfläche. Fragt nach einer Bestätigung, sofern nicht -y/--yes übergeben wird.

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

Option	Beschreibung
`-y, --yes`	Bestätigungsabfrage überspringen

Beispiel

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

biolink:reorder-buttons — Schaltflächen neu anordnen

Ordnet die Schaltflächen eines Biolinks neu an. Übergib die Schaltflächen-IDs als Positionsargumente in der gewünschten Anzeigereihenfolge.

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

Beispiel

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

Galerie

biolink:posts — Galeriebeiträge auflisten

Listet die Beiträge/Galerieeinträge eines Biolinks auf.

so-me biolink:posts <biolink-id>

Beispiel

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

biolink:add-post — Einen Galeriebeitrag hinzufügen

Fügt der Galerie einen Beitrag hinzu. Alle Optionen sind optional.

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

Option	Beschreibung
`--image <url>`	Bild-URL
`--caption <text>`	Bildunterschrift
`--link <url>`	Link-URL

Beispiel

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 — Einen Galeriebeitrag aktualisieren

Aktualisiert einen Galeriebeitrag. Gib mindestens eine Option an, sonst beendet sich der Befehl mit einem Fehler.

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

Option	Beschreibung
`--caption <text>`	Bildunterschrift
`--link <url>`	Link-URL
`--visible`	Auf sichtbar setzen
`--hidden`	Auf ausgeblendet setzen

Beispiel

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

biolink:delete-post — Einen Galeriebeitrag löschen

Löscht einen Galeriebeitrag. Fragt nach einer Bestätigung, sofern nicht -y/--yes übergeben wird.

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

Option	Beschreibung
`-y, --yes`	Bestätigungsabfrage überspringen

Beispiel

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

biolink:reorder-posts — Galeriebeiträge neu anordnen

Ordnet Galeriebeiträge neu an. Übergib die Beitrags-IDs als Positionsargumente in der gewünschten Anzeigereihenfolge.

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

Beispiel

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

Analysen

biolink:analytics

Ruft Analysen für einen Biolink ab, einschließlich Aufrufen, Klicks und Klickrate (CTR).

so-me biolink:analytics <id>

Beispiel

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

Erste Schritte

Veröffentlichen

AI Studio

Posteingang und Interaktion

Analysen

Biolink

Team und Zusammenarbeit

Einstellungen und Abrechnung

Webhooks

Support

Kernbefehle

biolink:list

biolink:get

biolink:public

biolink:create

biolink:update

biolink:delete

biolink:publish

Design

biolink:theme

Schaltflächen

Galerie

Analysen

biolink:analytics

​Kernbefehle

​biolink:list

​biolink:get

​biolink:public

​biolink:create

​biolink:update

​biolink:delete

​biolink:publish

​Design

​biolink:theme

​Schaltflächen

​Galerie

​Analysen

​biolink:analytics

Kernbefehle

biolink:list

biolink:get

biolink:public

biolink:create

biolink:update

biolink:delete

biolink:publish

Design

biolink:theme

Schaltflächen

Galerie

Analysen

biolink:analytics