S.EE Docs
Développeurs

CLI

Client en ligne de commande pour la plateforme S.EE

Un client en ligne de commande pour la plateforme S.EE, qui vous permet de créer et gérer des URL courtes, des extraits de texte et des fichiers directement depuis votre terminal.

Fonctionnalités

  • Gestion des URL courtes: créer, mettre à jour et supprimer des liens raccourcis avec slugs personnalisés, domaines et expiration
  • Extraits de texte: partager des extraits de code et des notes depuis stdin ou des fichiers
  • Téléversement de fichiers: téléverser des fichiers directement ou via stdin
  • Gestion des domaines et tags: lister les domaines disponibles et gérer les tags
  • Protection par mot de passe: sécuriser votre contenu avec des mots de passe
  • Sortie JSON: sortie lisible par machine pour les scripts

Installation

macOS

brew tap sdotee/homebrew-tap
brew install see

Debian / Ubuntu

dpkg -i see-cli_<version>_<arch>.deb

RHEL / Fedora

rpm -i see-cli_<version>_linux_<arch>.rpm

Arch Linux

yay -S see-cli
# or pre-built binary
yay -S see-cli-bin

Depuis les sources

go install github.com/sdotee/cli@latest

Téléchargez les binaires et paquets précompilés depuis GitHub Releases.

Configuration

Définissez votre clé API via une variable d’environnement ou un flag :

# Variable d’environnement (recommandée)
export SEE_API_KEY="your-api-key"

# Ou utilisez le flag
see --api-key "your-api-key" <command>

Options de configuration

OptionVariable d’environnementDescription
--api-keySEE_API_KEYVotre clé API S.EE (requise)
--base-urlSEE_BASE_URLURL de base API personnalisée
--timeoutSEE_TIMEOUTDélai d’expiration de la requête
--json-Active le format de sortie JSON

Commandes

Domaines et tags

# Lister les domaines disponibles pour les URL courtes
see domains

# Lister les domaines disponibles pour les téléversements de fichiers
see file domains

# Lister vos tags
see tags

URL courtes

# Créer une URL courte
see url create https://example.com

# Créer avec des options personnalisées
see url create https://example.com \
  --slug my-link \
  --domain s.ee \
  --title "My Link" \
  --password secret \
  --expires 2024-12-31

# Mettre à jour une URL courte
see url update --domain s.ee --slug my-link --title "New Title"

# Supprimer une URL courte
see url delete --domain s.ee --slug my-link

Extraits de texte

# Créer un texte depuis stdin
echo "Hello World" | see text create --title "greeting"

# Créer un texte depuis un fichier
see text create --file ./snippet.txt --title "Code Snippet"

# Créer avec des options
cat script.sh | see text create \
  --title "Shell Script" \
  --domain fs.to \
  --password secret \
  --expires 2024-12-31

# Mettre à jour le texte
see text update --domain fs.to --slug abc123 --title "Titre mis à jour"

# Supprimer le texte
see text delete --domain fs.to --slug abc123

Téléversement de fichiers

# Téléverser un fichier
see file upload ./image.png

# Téléverser avec un domaine personnalisé
see file upload ./document.pdf --domain fs.to

# Téléverser depuis stdin
cat image.png | see file upload --stdin --filename image.png

# Supprimer un fichier
see file delete <delete-hash>

Sortie JSON

Utilisez le flag --json pour obtenir une sortie lisible par machine, utile pour les scripts :

see url create https://example.com --json | jq '.short_url'

Exemples

Créer une URL courte et la copier dans le presse-papiers (macOS)

see url create https://example.com --json | jq -r '.short_url' | pbcopy

Téléverser une capture d’écran et obtenir l’URL (Linux)

see file upload ~/screenshot.png --json | jq -r '.url'

Créer des URL courtes par lot

while read url; do
  see url create "$url" --json
done < urls.txt

Sur cette page