Utilisation avancée

Tout ce qui suit montre la CLI en train d'effectuer des tâches que vous feriez autrement à la main : vérifier qu'un déploiement fonctionne, produire un rapport ou vous indiquer lequel des sept problèmes possibles est survenu.

Dans un pipeline

Il n'y a pas de navigateur dans la CI. La clé provient donc de l'environnement. Chaque commande lit WAJUB_API_KEY lorsqu'aucun profil n'est configuré.

#!/usr/bin/env bash
set -euo pipefail

export WAJUB_API_KEY="$WAJUB_SANDBOX_KEY"   # from your CI secret store

# Fail the job if the key, the network or the account is wrong
wajub doctor --json > doctor.json

# Fail the job if the webhook endpoint disappeared
wajub webhooks list --json \
  | jq -e '.items[] | select(.url == "https://example.com/webhooks/wajub")' > /dev/null

L'option --json rend la sortie de chaque commande exploitable, et jq -e transforme « aucun résultat » en code de sortie différent de zéro. C'est ce qui fait réellement échouer l'étape.

Rapports depuis le terminal

Les commandes de liste associées à jq remplacent de nombreux petits scripts.

# Yesterday's failures, with the reason
wajub payments list --status failed --since 2026-01-14 --until 2026-01-14 --json \
  | jq -r '.items[] | [.created_at, .id, .amount, .currency, .failure_reason] | @tsv'

# Payouts still not settled
wajub transfers list --status processing --json \
  | jq -r '.items[] | [.id, .amount, .currency, .created_at] | @tsv'

Rappelez-vous que --since et --until couvrent des journées calendaires entières. Pour une période plus courte, filtrez les horodatages dans jq après avoir récupéré la journée.

Communiquer avec un autre hôte

--api-base dirige une commande vers une autre API. Cette option permet de piloter une plateforme locale ou un environnement de staging sans toucher à vos profils.

wajub doctor --api-base http://api.wajub.test
wajub payments list --api-base http://api.wajub.test --limit 5

Pour un usage quotidien, créez plutôt un profil afin de ne jamais oublier l'option.

wajub config set local \
  --base-url http://api.wajub.test \
  --secret-key sk_test.mT9xW2kQ7vB4nL6hR1cY8dF3jS5aG0eU2pA…

wajub payments list --profile local

Autocomplétion du shell

wajub autocomplete

La commande affiche les deux lignes à ajouter au profil de votre shell, pour bash, zsh ou fish. Cette minute est bien investie : personne ne retient quatre-vingt-onze commandes.

Partir d'un exemple fonctionnel

$ wajub samples --list

Available samples:
  webhooks               Minimal webhook receiver with signature verification (Node.js, no dependencies)

$ wajub samples webhooks my-receiver

L'exemple de webhook ne contient volontairement aucune dépendance. Vous pouvez ainsi lire toute la vérification dans un seul fichier, sans passer par un framework.

Accéder au Dashboard

wajub open              # the dashboard home
wajub open payments
wajub open keys

Les pages reconnues sont balance, customers, dashboard, disputes, keys, payments, refunds, settings, transfers et webhooks.

Quand un problème survient

Trois commandes, dans l'ordre croissant du niveau de détail fourni.

$ wajub version
@wajub/cli/1.4.0 darwin-arm64 node-v22.11.0

$ wajub status
● Wajub API is reachable, https://api.wajub.com (HTTP 200)

$ wajub doctor
Wajub CLI diagnostics
  …seven checks, in order

status répond à la question « le problème vient-il de chez eux ou de chez moi ? » sans demander d'identifiants. doctor indique laquelle de vos sept configurations pose problème et termine par un identifiant de requête à transmettre au support.

Une commande inconnue échoue clairement au lieu d'effectuer une action inattendue.

$ wajub payment

 ›   Error: "payment" is not a wajub command. Run `wajub help` for the list.

Nous signaler ce qui manque

wajub feedback

La commande ouvre le formulaire de retour dans votre navigateur. Ajoutez-y l'identifiant de requête obtenu avec wajub doctor : les deux premières questions d'un échange avec le support auront déjà leur réponse.