API Fichiers
Lister et gérer les fichiers téléversés associés à vos formulaires.
L'API Fichiers vous permet de lister les fichiers téléversés associés à votre compte. Les fichiers sont créés lorsque les répondants soumettent des questions de téléversement de fichiers ou lorsque vous téléversez des médias (images, vidéos) dans le constructeur de formulaires.
Tous les corps de réponse utilisent des noms de champs en snake_case.
Lister les fichiers
/api/v1/filesRenvoie une liste paginée des fichiers téléversés pour l'utilisateur authentifié. Inclut les médias téléversés via le constructeur (appartenant à l'utilisateur) et les fichiers téléversés par les répondants (associés aux formulaires de l'utilisateur).
Paramètres de requête
pageintegerNuméro de page (par défaut : 1)
per_pageintegerRésultats par page (par défaut : 50)
Champs de réponse
idstringIdentifiant unique du fichier téléversé
blob_urlstringURL publique pour accéder au fichier
original_namestringNom de fichier original tel que téléversé par l'utilisateur
uuid_namestringNom de fichier basé sur UUID utilisé dans le stockage blob
sizeintegerTaille du fichier en octets
content_typestringType MIME du fichier (ex. "image/png", "application/pdf")
form_idstring or nullLe formulaire auquel ce fichier est associé (pour les téléversements de répondants)
user_idstring or nullL'utilisateur qui a téléversé ce fichier (pour les médias du constructeur). null pour les téléversements de répondants.
created_atstringHorodatage ISO 8601 du téléversement
Types de fichiers
Les fichiers se répartissent en deux catégories selon les champs user_id et form_id :
| Catégorie | user_id | form_id | Description |
|---|---|---|---|
| Média du constructeur | Défini | null ou défini | Images, vidéos ou documents téléversés par vous dans le constructeur de formulaires (ex. images de questions, logos) |
| Téléversements de répondants | null | Défini | Fichiers soumis par les répondants via les questions de téléversement de fichiers |
Limites de stockage
Le stockage de fichiers est suivi par compte. Vous pouvez vérifier votre utilisation actuelle via l'API Utilisateur. Les limites de stockage varient selon le niveau d'abonnement. Lorsqu'un formulaire est supprimé, les fichiers téléversés par les répondants associés sont nettoyés et le stockage est récupéré de manière asynchrone.
Réponse
{
"files": [
{
"id": "668a1b2c3d4e5f6a7b8c9d01",
"blob_url": "https://abcdef.public.blob.vercel-storage.com/uploads/a1b2c3d4.pdf",
"original_name": "project-proposal.pdf",
"uuid_name": "a1b2c3d4.pdf",
"size": 245760,
"content_type": "application/pdf",
"form_id": "665a1b2c3d4e5f6a7b8c9d0e",
"user_id": null,
"created_at": "2026-02-25T14:30:00.000Z"
},
{
"id": "668a1b2c3d4e5f6a7b8c9d02",
"blob_url": "https://abcdef.public.blob.vercel-storage.com/uploads/e5f6a7b8.png",
"original_name": "hero-banner.png",
"uuid_name": "e5f6a7b8.png",
"size": 1048576,
"content_type": "image/png",
"form_id": null,
"user_id": "665a0a1b2c3d4e5f6a7b8c9d",
"created_at": "2026-02-20T10:15:00.000Z"
}
],
"total": 38,
"page": 1,
"per_page": 50
}
Exemples de code
curl -X GET "https://api.nueform.io/api/v1/files?page=1&per_page=20" \
-H "Authorization: Bearer YOUR_API_KEY"
Réponses d'erreur
Réponses d'erreur standard renvoyées par ce point d'accès.
Codes d'erreur
401UnauthorizedClé API manquante ou invalide
500Server ErrorErreur interne du serveur
Exemple d'erreur
{
"error": "Unauthorized"
}