CLIAPI

Plan en publiceer vanuit de terminal

fopost is de officiële FoPost CLI: één statisch binair bestand zonder iets anders te installeren. Maak een post, voeg media toe, plan hem in op alle gekoppelde accounts en controleer elke levering, vanuit je shell, een script of een CI-job.

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"

Eén binair bestand

macOS, Linux en Windows op amd64 en arm64. Installeer met Homebrew, go install of een release-archief.

Gebouwd voor scripts

Elk commando accepteert --json, fouten gaan naar stderr en elke fout heeft een eigen exitcode.

Niets wordt per ongeluk gepost

Een post blijft een concept totdat je --publish meegeeft, posts publish uitvoert of een planning instelt.

Posts

Maak, plan en publiceer met één commando

posts create accepteert de accounts, de tekst, lokale mediabestanden en een tijdstip. Bestanden worden geüpload naar je mediabibliotheek en voor je toegevoegd. Lange teksten komen uit een bestand of een pipe, en preflight controleert een post op elk doelnetwerk voordat er iets wordt verstuurd.

Lees de posts-commando's
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

Inplannen of publiceren

Geef een tijdstip mee om in te plannen, --publish om nu te versturen, of niets om een concept te bewaren.

Preflight

Zie welke accounts klaar of geblokkeerd zijn, en waarom, voordat je publiceert.

Leveringsstatus

Status per account, pogingen en de live link zodra een netwerk er een heeft.

Scripting

JSON eruit, exitcodes terug

Voeg --json toe aan elk commando en stuur het resultaat door naar jq. Een 401, een 404, een limiet voor aanvragen en een foute aanvraag eindigen elk met een andere code, zodat een script ze kan onderscheiden zonder tekst te parseren. Nieuwe pogingen en backoff gebeuren automatisch bij elke aanvraag.

Lees de scriptinggids
Accounts die aandacht nodig hebben
fopost accounts health --json \
  | jq -r '.accounts[] | select(.healthStatus != "healthy") | .id' \
  | xargs -I{} fopost accounts validate {} --quiet

--json overal

De resource zelf, ingesprongen, op stdout. Tabellen zijn voor mensen.

Aparte exitcodes

Foute invoer, authenticatie, rechten, niet gevonden, limiet voor aanvragen en serverfouten hebben er elk een.

Ingebouwde nieuwe pogingen

Limieten, serverfouten en netwerkstoringen worden opnieuw geprobeerd met backoff.

CI

Post vanuit je pipeline

Stel je API-sleutel in als secret, geef de workspace mee en de CLI heeft geen opgeslagen configuratie nodig. Kondig een release aan, deel een changelog of blokkeer een merge wanneer preflight faalt. Voor GitHub is er ook een officiële Action die dezelfde flow omhult.

Begin met bouwen
Releasenotes bij elke tag
FOPOST_API_KEY=$FOPOST_API_KEY fopost posts create \
  --workspace "$WORKSPACE_ID" \
  --account "$ACCOUNT_ID" \
  --text-file release-notes.md \
  --publish --json --quiet

Sleutel uit de omgeving

FOPOST_API_KEY wordt automatisch gelezen. Geen login in CI.

Elk CI-systeem

GitHub Actions, GitLab CI of alles wat een shell draait.

Automatiseringen en webhooks

Start automatiseringen en beheer webhook-abonnementen met dezelfde tool.

Vragen over CLI, beantwoord

Hoe installeer ik de CLI?

Voer brew install fopost/tap/fopost uit, of go install github.com/fopost/fopost-cli@latest, of download het archief voor je platform van de GitHub-releasepagina en zet fopost in je PATH.

Heb ik een account nodig?

Ja. De CLI praat met de gehoste FoPost API, dus je hebt een API-sleutel nodig, die je maakt in het dashboard onder Instellingen, API-sleutels. fopost auth login slaat hem op, of stel FOPOST_API_KEY in.

Waar wordt mijn API-sleutel opgeslagen?

In je gebruikersconfiguratiemap, alleen leesbaar voor jou. De CLI toont hem nooit terug: auth status toont een afgeschermd voorvoegsel en uitgebreide uitvoer laat hem weg.

Wat kan het?

Posts, accounts en hun status, workspaces, media-uploads, labels, analyses, automatiseringen en webhooks. Voer fopost --help uit of lees de CLI-documentatie voor elk commando.

Is het open source?

Ja. De CLI heeft een MIT-licentie en de broncode staat op GitHub op fopost/fopost-cli.

Bouw vandaag nog op de CLI

Starten is gratis en de volledige API is inbegrepen. Maak een sleutel aan en doe binnen enkele minuten je eerste aanroep.

Haal je API-sleutel op