Skip to main content
Le CLI verifner accélère l’intégration : on teste un document en une commande, on scanne un QR code pour parcourir le vrai parcours sur son téléphone, et on reçoit les webhooks sur sa machine sans URL publique.

​
Installation

1

Vérifiez Node.js

Le CLI demande Node.js 20 ou plus récent. Dans un terminal :
Si la commande est introuvable ou affiche une version inférieure à v20, installez la version LTS depuis nodejs.org (Windows, macOS, Linux), puis rouvrez le terminal.
2

Installez le CLI

La commande verifner est ensuite disponible partout.
3

Vérifiez l'installation

Affiche le numéro de version, par exemple 0.1.0.
4

Connectez votre clé

Dans la console, Clés API → Nouvelle clé, mode Test. Puis :
Collez la clé vn_test_… quand elle est demandée. Le CLI la vérifie auprès de l’API, puis l’enregistre dans ~/.config/verifner/config.json, lisible par vous seul. Vous pouvez aussi la passer directement : verifner login --key vn_test_….
5

Premier essai

Scannez le QR code avec votre téléphone, faites le parcours : le verdict s’affiche dans le terminal.
Utilisez une clé de test pour développer : rien n’est facturé et aucune image n’est conservée. Avec une clé live, chaque vérification est facturée.

​
En cas de problème

Le dossier des commandes globales de npm n’est pas dans votre PATH. Affichez-le avec npm prefix -g : les commandes sont dans son sous-dossier bin (macOS, Linux) ou dans ce dossier même (Windows). Ajoutez-le à votre PATH, rouvrez le terminal, ou utilisez npx @verifner/cli en attendant.
npm essaie d’écrire dans un dossier système. N’utilisez pas sudo : installez Node.js avec un gestionnaire de versions (nvm, fnm ou Volta), qui place les paquets globaux dans votre dossier personnel, puis relancez l’installation.
Lancez verifner login, ou définissez la variable VERIFNER_API_KEY.
La clé est inconnue ou a été révoquée. Créez-en une nouvelle dans la console et relancez verifner login.
Le CLI passe par HTTPS vers api.verifner.com. Si votre réseau impose un proxy, configurez-le pour npm (npm config set proxy …) et pour Node.js (variables HTTPS_PROXY), ou demandez à votre équipe réseau d’autoriser ce domaine.

​
Mettre à jour, désinstaller

​
En intégration continue

Les variables VERIFNER_API_KEY et VERIFNER_API_URL remplacent la configuration enregistrée : pas besoin de login sur une machine de build.

​
Toutes les commandes

Options communes : --json pour une sortie JSON, --lang en pour les justifications en anglais.

​
Vérifier des photos

--json pour la réponse brute de l’API, --lang en pour les justifications en anglais.

​
Ouvrir un lien de vérification

Le CLI crée une session, affiche le lien hébergé en QR code : scannez-le avec votre téléphone, faites le parcours, et le verdict s’affiche dans le terminal dès qu’il est prêt. --no-wait rend la main tout de suite.

​
Recevoir les webhooks en local

Chaque événement verification.completed de votre organisation arrive en direct et est relayé à votre serveur local exactement comme un vrai webhook : mêmes en-têtes (VerifNer-Event, VerifNer-Delivery), même signature VerifNer-Signature. Le CLI affiche le secret de signature à mettre dans votre serveur (VERIFNER_WEBHOOK_SECRET) ; il reste le même d’une session à l’autre. Voir Webhooks pour vérifier la signature.
Sans --forward, les événements s’affichent seulement. Le flux ne montre que les événements du mode de votre clé (test ou live) et de son application.

​
Suivre vos appels

Les derniers appels à l’API (statut, route, durée, code d’erreur, clé) puis, avec -f, chaque nouvel appel dès qu’il arrive : les mêmes informations que la page Journaux de la console, jamais le contenu des documents.