CLIAPI

Planifiez et publiez depuis le terminal

fopost est la CLI officielle de FoPost : un seul binaire statique, sans rien d'autre à installer. Créez un post, joignez des médias, planifiez-le sur tous les comptes connectés et vérifiez chaque livraison, depuis votre shell, un script ou un job de CI.

brew install fopost/tap/fopost
fopost auth login

fopost posts create \
  --account acc_9f2c4a7b \
  --account acc_1ee3d5a0 \
  --text "We shipped dark mode. Every surface, every chart." \
  --media ./screenshots/dark-mode.png \
  --schedule-at "2026-09-01 09:00"

Un seul binaire

macOS, Linux et Windows en amd64 et arm64. Installez avec Homebrew, go install ou une archive de release.

Conçue pour les scripts

Chaque commande accepte --json, les erreurs vont sur stderr et chaque échec a son propre code de sortie.

Rien ne part par surprise

Un post reste un brouillon tant que vous ne passez pas --publish, n'exécutez pas posts publish ou ne définissez pas une planification.

Posts

Créez, planifiez et publiez en une commande

posts create prend les comptes, le texte, les fichiers médias locaux et une heure. Les fichiers sont envoyés dans votre médiathèque et joints pour vous. Un texte long peut venir d'un fichier ou d'un pipe, et preflight vérifie un post sur chaque réseau cible avant tout envoi.

Lire les commandes posts
Posts
git log -1 --pretty=%s | \
  fopost posts create --account acc_9f2c4a7b --text-file - --draft

fopost posts preflight post_7d2a
fopost posts publish post_7d2a
fopost posts deliveries post_7d2a

Planifier ou publier

Indiquez une heure pour planifier, --publish pour envoyer maintenant, ou rien pour garder un brouillon.

Preflight

Voyez quels comptes sont prêts ou bloqués, et pourquoi, avant de publier.

Statut de livraison

Statut par compte, tentatives et lien en ligne dès que le réseau en fournit un.

Scripts

JSON en sortie, codes de sortie en retour

Ajoutez --json à n'importe quelle commande et redirigez le résultat vers jq. Un 401, un 404, une limite de débit et une requête invalide se terminent chacun par un code différent, un script peut donc les distinguer sans analyser de texte. Les nouvelles tentatives et le backoff se font en interne à chaque requête.

Lire le guide des scripts
Comptes qui demandent de l'attention
fopost accounts health --json \
  | jq -r '.accounts[] | select(.healthStatus != "healthy") | .id' \
  | xargs -I{} fopost accounts validate {} --quiet

--json partout

La ressource elle-même, indentée, sur stdout. Les tableaux sont pour les humains.

Codes de sortie distincts

Entrée invalide, authentification, droits, introuvable, limite de débit et erreurs serveur ont chacun le leur.

Nouvelles tentatives intégrées

Les limites de débit, erreurs serveur et pannes réseau sont retentées avec backoff.

CI

Publiez depuis votre pipeline

Définissez votre clé d'API comme secret, indiquez le workspace, et la CLI n'a besoin d'aucune configuration enregistrée. Annoncez une version, partagez un changelog ou bloquez un merge quand preflight échoue. Pour GitHub, il existe aussi une Action officielle qui reprend le même flux.

Commencer à créer
Notes de version à chaque tag
FOPOST_API_KEY=$FOPOST_API_KEY fopost posts create \
  --workspace "$WORKSPACE_ID" \
  --account "$ACCOUNT_ID" \
  --text-file release-notes.md \
  --publish --json --quiet

Clé depuis l'environnement

FOPOST_API_KEY est lue automatiquement. Pas d'étape de login en CI.

Tout système de CI

GitHub Actions, GitLab CI, ou tout ce qui exécute un shell.

Automatisations et webhooks

Déclenchez des automatisations et gérez vos abonnements webhook depuis le même outil.

CLI : vos questions, nos réponses

Comment installer la CLI ?

Exécutez brew install fopost/tap/fopost, ou go install github.com/fopost/fopost-cli@latest, ou téléchargez l'archive de votre plateforme depuis la page des releases GitHub et placez fopost dans votre PATH.

Faut-il un compte ?

Oui. La CLI communique avec l'API hébergée de FoPost, elle a donc besoin d'une clé d'API, que vous créez dans le tableau de bord sous Paramètres, Clés d'API. fopost auth login l'enregistre, ou définissez FOPOST_API_KEY à la place.

Où est stockée ma clé d'API ?

Dans le dossier de configuration de votre utilisateur, lisible par vous seul. La CLI ne l'affiche jamais : auth status montre un préfixe masqué et la sortie détaillée l'omet.

Que peut-elle faire ?

Posts, comptes et leur état, workspaces, envoi de médias, étiquettes, statistiques, automatisations et webhooks. Exécutez fopost --help ou consultez la documentation de la CLI pour chaque commande.

Est-elle open source ?

Oui. La CLI est sous licence MIT et son code source est sur GitHub, à fopost/fopost-cli.

Développez avec CLI dès aujourd'hui

Le démarrage est gratuit et l'API complète est incluse. Créez une clé et faites votre premier appel en quelques minutes.

Obtenir votre clé d'API