L'URL de base est :
https://takeoff.kreo.net/api/general/v1/takeoff2DToutes les demandes nécessitent votre clé API dans l'en-tête X-API-KEY (voir Démarrage avec l'API Kreo pour savoir comment en créer une).
L'API suit une séquence logique allant des fichiers bruts aux données de mesure structurées :
Télécharger les fichiers — envoyez les documents bruts aux serveurs de Kreo.
Créer un projet — initialisez un espace de travail de projet à partir des fichiers téléchargés.
Extraire les données — interrogez le projet pour obtenir les détails des fichiers, les groupes et les mesures.
Exporter en PDF — générez un PDF traité avec les mesures rendues sur les dessins.
POST /upload accepte un ou plusieurs fichiers en tant que données de formulaire multipart (champ files) et retourne un tableau de clés de fichier. Formats supportés : PDF, CAO (DWG, DXF, DWF, DGN) et images (PNG, TIFF, JPG, JPEG, BMP, EMF, GIF). Les fichiers doivent avoir des extensions valides dans leurs noms.
POST /project crée un projet à partir des fichiers téléchargés :
json
{
"fileKeys": ["key-1", "key-2"],
"name": "My Project"
}Contrairement à l'API AI Search, un projet Core Platform peut contenir plusieurs fichiers, chacun avec plusieurs pages. La réponse contient l'identifiant projectId.
GET /projects/{projectId}/files retourne les fichiers du projet avec leur statut de traitement (Ready, Calculating, ou Failed) et leurs pages. Chaque page inclut son UUID, son nom, l'index de la page, les dimensions, le coefficient d'échelle et un indicateur hasMeasurements pour que vous puissiez rapidement trouver les pages contenant des données de déboursé. Notez que la liste des pages peut être vide tant qu'un fichier est encore en cours de Calculating.
GET /projects/{projectId}/groups retourne la structure de groupe (dossier) du projet. Chaque groupe possède un UUID, un nom, une couleur, un index d'ordre, un groupe parent optionnel et la liste des UUID de mesures qu'il contient — suffisant pour reconstruire l'arborescence complète des métrés exactement telle qu'elle apparaît dans Kreo.
GET /projects/{projectId}/measurements retourne chaque mesure du projet. Chaque mesure comprend :
Identité: UUID, nom, le groupe auquel elle appartient et la page sur laquelle elle est dessinée
Style: couleur, style de trait (Normal, Dashed, DashDoted), et épaisseur du trait
Géométrie: le type (Areal, Linear, ou Countable) et les points sous forme de paires [x, y]
Quantités: surface, périmètre, longueur, hauteur, épaisseur, surface verticale et volume — selon ce qui s'applique au type de mesure
C'est généralement le point de terminaison autour duquel vous construirez votre intégration : il vous fournit les données de quantité complètes à alimenter dans les estimations, les métrés ou les outils de reporting.
POST /projects/{projectId}/pdf-export génère les dessins du projet avec les mesures dans un PDF. Le seul paramètre obligatoire est le système d'unités :
json
{
"unitSystem": "Metric"
}Les paramètres facultatifs vous donnent un contrôle précis sur la sortie : filtrer par pages spécifiques (pageIds) ou mesures (measurementIds), activer/désactiver les étiquettes pour les noms, surfaces, périmètres et longueurs de segments, inclure ou exclure les autocollants, les règles et les fils de discussion, ajuster la taille de la police et l'épaisseur des lignes, choisir un style de comptage et passer en niveaux de gris. La réponse est le fichier PDF lui-même.
Les schémas complets et un explorateur interactif sont disponibles dans notre portail développeur : Aperçu de l'API Core Platform.
Des questions ? Contactez-nous à [email protected] ou via le chat intégré.