Nous proposons une API publique permettant de créer des projets de manière automatisée en important un fichier ZIP contenant vos documents. Cette fonctionnalité est disponible en tant qu'option complémentaire — contactez votre référent Tenderbolt pour l'activer.

🛠️ Prérequis

Avant de commencer :

Vous devez disposer d'une clé API Tenderbolt. Contactez votre équipe support pour obtenir votre clé.
Vous devez préparer un fichier ZIP contenant les documents de votre projet. Le ZIP ne peut pas contenir plus de 200 documents.
Vous pouvez optionnellement renseigner les adresses e-mail des responsables et des contributeurs à ajouter au projet.

📡 Accéder à la documentation API

La documentation complète de l'API est disponible à l'adresse suivante : 🔗 https://api.tenderbolt.ai/api/public/v1/docs

🚀 Étapes pour créer un projet

La création d'un projet via l'API se fait en trois étapes.

Étape 1 : Obtenir une URL signée pour uploader votre fichier

Appelez l'endpoint suivant pour obtenir une URL d'upload temporaire :

Endpoint : POST /api/public/v1/files

Headers :

X-API-Key: votre_clé_api Content-Type: application/json

Body :

{   "filename": "mon_projet.zip" }

Réponse :

{   "url": "https://...",   "id": "temp_file_id_123",   "expiration": 3600 }

💡 L'URL générée expire après un certain temps (indiqué en secondes). Uploadez votre fichier rapidement !

Étape 2 : Uploader votre fichier ZIP

Utilisez l'URL obtenue à l'étape 1 pour uploader votre fichier :

Requête : PUT vers l'URL signée

Body : Le contenu binaire de votre fichier ZIP

Étape 3 : Créer le projet

Une fois le fichier uploadé, créez le projet en utilisant l'ID du fichier :

Endpoint : POST /api/public/v1/projects/from_zip

Headers :

X-API-Key: votre_clé_api Content-Type: application/json

Body :

{   "file_id": "temp_file_id_123",   "title": "Mon appel d'offres 2026",   "owners": ["[email protected]"],   "contributors": ["[email protected]"],   "language": "FR" }

Paramètres :

file_id (obligatoire) : L'ID retourné à l'étape 1
title (optionnel) : Le nom du projet. S'il n'est pas renseigné, le titre est extrait des documents importés.
owners (optionnel) : Liste des adresses e-mail des responsables du projet. Ces membres doivent déjà faire partie de votre organisation sur Tenderbolt.
contributors (optionnel) : Liste des adresses e-mail des contributeurs du projet. Ces membres doivent déjà faire partie de votre organisation sur Tenderbolt.
language (optionnel, défaut : FR) : Langue du projet. Valeurs acceptées : AL, BG, CA, CZ, DE, DK, EE, EL, EN, EN_GB, EN_US, ES, FI, FR, HR, HU, IT, LT, LV, NL, NO, PL, PT, RO, RS, SI, SK, SV, TR, UA

Réponse :

{   "id": "projet_abc123" }

id : Identifiant du projet créé

🎉 Votre projet est créé ! Vous pouvez maintenant y accéder sur la plateforme Tenderbolt.

⚠️ Problèmes courants

Erreur d'authentification (401)

Vérifiez que votre clé API est correcte et présente dans le header X-API-Key
Contactez le support si votre clé n'est plus valide

Fichier expiré (403 — file_upload_expired)

L'URL signée a une durée de validité limitée. Si vous obtenez ce code, recommencez le processus depuis l'étape 1 pour obtenir une nouvelle URL.

Fichier introuvable (403 — file_not_found)

Le file_id transmis ne correspond à aucun fichier uploadé. Vérifiez que vous utilisez bien l'id retourné à l'étape 1, et que l'upload de l'étape 2 s'est terminé correctement.

Fichier trop volumineux (413 — file_too_large)

La taille de votre fichier ZIP dépasse la limite autorisée. Réduisez la taille du fichier ou contactez votre référent Tenderbolt.

Fichier trop petit (422 — file_too_small)

La taille de votre fichier ZIP est en dessous de la limite minimale. Vérifiez que le ZIP contient bien des documents et n'est pas vide ou corrompu.

Aucun fichier fourni (422 — file_not_provided)

Le champ file_id est absent ou vide dans le corps de la requête. Il est obligatoire.

Format de fichier incorrect (422 — file_not_zipfile)

Vérifiez que votre fichier est bien au format ZIP
Assurez-vous que le ZIP n'est pas corrompu et qu'il contient des documents

Trop de documents (422 — too_many_documents)

Votre ZIP contient plus de 200 documents. Répartissez les documents sur plusieurs projets, ou retirez les fichiers non nécessaires à l'analyse.

Membre introuvable

Assurez-vous que les adresses e-mail des membres (owners et contributors) existent dans votre organisation Tenderbolt
Vérifiez qu'il n'y a pas de faute de frappe dans les adresses e-mail

💡 Exemple complet avec cURL

# Étape 1 : Obtenir l'URL signée curl -X POST https://api.tenderbolt.ai/api/public/v1/files \   -H "X-API-Key: votre_clé_api" \   -H "Content-Type: application/json" \   -d '{"filename": "mon_projet.zip"}'# Étape 2 : Uploader le fichier (remplacer URL_SIGNEE par l'URL obtenue) curl -X PUT "URL_SIGNEE" \   --data-binary @mon_projet.zip# Étape 3 : Créer le projet curl -X POST https://api.tenderbolt.ai/api/public/v1/projects/from_zip \   -H "X-API-Key: votre_clé_api" \   -H "Content-Type: application/json" \   -d '{     "file_id": "temp_file_id_123",     "title": "Mon appel d'\''offres 2026",     "owners": ["[email protected]"],     "contributors": ["[email protected]"],     "language": "FR"   }'

En savoir plus ?

📚 Consultez nos autres guides détaillés dans le Centre d'aide.

🔑 Besoin d'une clé API ? Contactez votre équipe support Tenderbolt.

📧 Besoin d'aide ? Contactez votre administrateur ou votre référent Tenderbolt.

Articles connexes

Créer un projet via API