Recevoir des fichiers par l'API de la boîte noire

Votre logiciel de facturation, un scanner ou un script envoie un fichier à votre boîte noire. Elle le chiffre pour une boîte de dépôt permanente, et votre appli Filarr le range ensuite dans le dossier choisi, selon vos règles. Le logiciel apprend « rangé », jamais où.

Les fichiers par l'API sont offerts à partir de Pro (Pro, Teams, Enterprise). Le nombre et le volume des dépôts du mois ont un plafond qui dépend du palier : il s'affiche dans Paramètres → Accès API (Fichiers reçus (mois)). Côté boîte noire, Filarr Gate 0.3.1, la version publiée, sait déposer.

Comment ça marche

Le logiciel envoie le fichier à la boîte noire, avec une clé d'application qui a le droit de déposer des fichiers.
La boîte noire le filtre (exécutables, taille), calcule son empreinte, le chiffre pour votre boîte de dépôt et le dépose chez Filarr.
Filarr garde le dépôt scellé, sans pouvoir l'ouvrir.
Un de vos appareils où Filarr est ouvert (bureau ou web) ouvre le dépôt, vérifie l'empreinte, et le range selon vos règles de placement.
La boîte noire apprend que le fichier est rangé, et quand.

C'est une fente : la boîte noire dépose, elle ne peut ni lister, ni relire, ni supprimer ce qui est rangé. Un jeton volé permet de déposer, jamais de lire vos fichiers.

Qui voit quoi

qui	voit	ne voit jamais
Filarr	un dépôt scellé, sa taille, l'heure, l'accès, l'adresse IP de la boîte noire	le nom, le chemin demandé, les étiquettes, l'empreinte, la règle, le dossier final
la boîte noire	le fichier, qu'elle chiffre	où il est rangé, sous quel nom, ce que contient votre coffre
votre appli	tout, pour ranger

Mettre en place

Sur une base, cliquez sur ··· puis Ouvrir à une API… (Ouvrir une base à une API). Sous Ce que l'accès ouvre, cochez Recevoir des fichiers. Choisissez la Boîte de dépôt : une des vôtres, ou une Nouvelle boîte « Entrées API » avec son Dossier cible. Cette boîte reçoit aussi les dépôts par lien de la passerelle.
Créez l'accès et donnez son jeton à la boîte noire, comme pour une base.
Réglez au besoin les règles de placement : Paramètres → Accès API → Fichiers reçus, puis Règles de placement.
Dans la boîte noire, créez une clé d'application qui peut déposer : filarr-gate keys create --name ERP --files, ou, dans son interface de gestion, Clés des applications › Nouvelle clé en ne cochant que « Déposer des fichiers ».
Le logiciel envoie ses fichiers à l'adresse de la boîte noire :

curl -H "Authorization: Bearer gk_live_..." \
  -F "file=@facture-2291.pdf" \
  -F "path=Factures/2026/10" \
  -F "tags=facture,fournisseur" \
  https://boite.example.com/v1/files

La réponse :

{
  "id": "dp_ZgD1ambaYz0Mgg54",
  "status": "deposited",
  "depositedAt": "2026-10-10T03:33:18.935Z",
  "seq": 2
}

path demande un sous-dossier, que Filarr n'accepte que si vous l'avez permis ; tags peut guider les règles.

Suivre un dépôt

GET /v1/files/<id> sur la boîte noire rend l'état du dépôt :

état	ce qu'il veut dire
`deposited`	Filarr le garde ; aucun appareil ne l'a encore rangé
`filed`	rangé (ou reconnu comme doublon et laissé), avec l'heure
`rejected`	votre appli l'a refusé : l'empreinte ne correspondait pas, ou le dépôt était illisible
`expired`	jamais rangé pendant la durée de conservation de la boîte

La boîte noire peut aussi prévenir votre logiciel par un webhook file.filed quand le fichier est rangé.

Ce que la boîte noire refuse, avant tout envoi

les exécutables et scripts, par leur extension (.exe, .msi, .bat, .cmd, .ps1, .sh, .js, .app, .jar, .dll et d'autres) et par leurs premiers octets, quelle que soit l'extension ;
un fichier de plus de 100 Mio (l'administrateur de la boîte noire peut baisser ce plafond, jamais le monter) ;
tout dépôt quand 200 fichiers attendent déjà d'être rangés dans la boîte.

Ces refus restent dans le journal de la boîte noire, chez vous : ils ne sont jamais partis. Filarr ne peut d'ailleurs rien analyser, puisque le fichier lui arrive chiffré. Rien de ce qui est rangé n'est jamais exécuté par Filarr.

Quand les fichiers attendent

Seule votre appli tient la clé du dossier : les fichiers se rangent pendant que Filarr est ouvert sur le bureau ou le web, au prochain passage (toutes les 5 minutes). Un appareil range la boîte tant que Ranger automatiquement sur cet appareil n'y est pas coupé (Paramètres → Intégrations) ; Ranger maintenant le fait sur-le-champ.

À 200 fichiers en attente, la boîte noire refuse les nouveaux dépôts : attendre ne suffit pas, ouvrez Filarr. Le téléphone affiche combien de fichiers attendent, mais ne les range pas.

Les fichiers reçus

Paramètres → Accès API → Fichiers reçus montre, pour chaque accès qui reçoit des fichiers : les fichiers du mois et ce qui attend un appareil, la boîte de dépôt, le placement. Voir le journal des fichiers reçus ouvre le détail : l'heure, le fichier, la clé d'application, le résultat (rangé, doublon laissé, chemin refusé, refusé, attend un appareil, expiré) et le dossier où il a été rangé. Ce détail est scellé pour vos appareils : seule votre appli l'ouvre.

Chaque fichier rangé garde sa provenance dans ses informations chiffrées : l'accès, la clé d'application, le nom d'origine, la règle appliquée.

Pour aller plus loin

Règles de placement des fichiers reçus
Recevoir et envoyer tout seul, pour les boîtes de dépôt
Le tutoriel complet, en curl, JavaScript et Python : github.com/filarr-work/filarr-gate.