Aegis Chantier  / API Reference
Demander l'accès Essai gratuit
v1.0 — Disponible en bêta privé

API Aegis Chantier

Intégrez la génération de devis BTP par IA directement dans votre logiciel. Photo du chantier + description vocale — devis structuré JSON ou PDF Factur-X en moins de 2 minutes.

BASE URL https://chantier.aegisprops.com/api/v1
2 min
Devis généré par appel API
5
Endpoints REST
Factur-X
Conformité 2026 incluse
50
Appels/mois gratuits

Authentification

Toutes les requêtes sont authentifiées via une clé API transmise dans l'en-tete HTTP Authorization.

Clé API requise

Ajoutez Authorization: Bearer YOUR_API_KEY à chaque requête. Obtenez votre clé en écrivant à contact@aegisprops.com.

HTTP 
POST https://chantier.aegisprops.com/api/v1/quotes/generate
Authorization: Bearer ac_live_xxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: multipart/form-data

Endpoints

L'API expose 5 endpoints couvrant la génération de devis, l'export PDF, la consultation de tarifs matériaux, l'OCR de factures fournisseur et le health check.

POST /v1/quotes/generate Générer un devis depuis photo et/ou voix ▼

Envoie une photo de chantier et/ou une description textuelle ou vocale. L'IA analyse les éléments visibles, déduit les postes de travaux et retourne un devis structuré avec lignes de prix, quantités estimées et total HT/TTC.

Corps de la requête — multipart/form-data
Parametre Type Requis Description
photo file optionnel Photo du chantier (JPEG, PNG, HEIC — max 10 Mo)
description string optionnel Description textuelle des travaux. Au moins photo ou description est requis.
trade string requis plomberie | electricite | peinture | maconnerie | general
company_name string optionnel Raison sociale de l'artisan (utilisée dans le PDF)
client_name string optionnel Nom du client final
voice_note file optionnel Note vocale MP3/WAV/M4A — transcrite par Whisper avant analyse
Python 
import requests

response = requests.post(
    "https://chantier.aegisprops.com/api/v1/quotes/generate",
    headers={"Authorization": "Bearer ac_live_xxx"},
    files={"photo": open("chantier.jpg", "rb")},
    data={
        "trade": "plomberie",
        "description": "Remplacement chauffe-eau 150L",
        "company_name": "Martin Plomberie",
    }
)

quote = response.json()
# quote["id"] → utilisable pour /pdf
Reponse 200 
{
  "id":          "qte_01HX7NZ...",
  "reference":   "DEV-2026-0042",
  "trade":       "plomberie",
  "company":     "Martin Plomberie",
  "lines": [
    {
      "description": "Chauffe-eau thermodynamique 150L",
      "qty":         1,
      "unit":        "u",
      "unit_price_ht": 680.00,
      "tva_rate":    0.10
    },
    {
      "description": "Main d'oeuvre pose",
      "qty":         3,
      "unit":        "h",
      "unit_price_ht": 55.00,
      "tva_rate":    0.10
    }
  ],
  "total_ht":    845.00,
  "total_tva":   84.50,
  "total_ttc":   929.50,
  "pdf_url":     "/api/v1/quotes/qte_01HX7NZ.../pdf",
  "created_at":  "2026-04-18T10:32:00Z"
}
POST /v1/quotes/{id}/pdf Générer le PDF Factur-X ▼

Généré et retourne le PDF du devis au format Factur-X (norme EN 16931), conforme à l'obligation de facturation électronique 2026. La réponse est le binaire PDF — Content-Type: application/pdf.

Paramètre de chemin
ParametreTypeDescription
id string Identifiant du devis retourne par /generate
Python 
r = requests.post(
    f"https://chantier.aegisprops.com/api/v1/quotes/{quote_id}/pdf",
    headers={"Authorization": "Bearer ac_live_xxx"}
)
with open("devis.pdf", "wb") as f:
    f.write(r.content)  # PDF Factur-X EN 16931
GET /v1/pricing/lookup Consulter les tarifs matériaux ▼

Retourne les prix unitaires de référence pour un matériau ou une prestation BTP. Base de données de tarifs régionalisée, actualisée mensuellement.

Paramètres de requête
ParametreTypeRequisDescription
q string requis Terme de recherche (ex: "chauffe-eau", "m2 peinture")
trade string optionnel Filtre par corps de métier
region string optionnel Code région INSEE (ex: "75" = Paris)
POST /v1/ocr/invoice OCR facture fournisseur ▼

Extrait les données structurées d'une facture fournisseur (PDF ou image). Utile pour les flux achat/comptabilité dans les ERP et logiciels BTP.

Corps — multipart/form-data
ParametreTypeDescription
file file Facture en PDF, JPEG ou PNG (max 20 Mo)
Reponse 200 
{
  "vendor":        "Leroy Merlin",
  "invoice_date": "2026-04-15",
  "invoice_num":  "FAC-2026-88712",
  "total_ht":     342.50,
  "total_ttc":    411.00,
  "lines": [...]
}
GET /v1/health Statut de l'API ▼

Retourne le statut opérationnel de l'API. Pas d'authentification requise. Utilisable pour le monitoring.

Reponse 200 
{ "status": "ok", "version": "1.0.0" }

Codes d'erreur

Code HTTP Code erreur Description
400invalid_requestParamètre manquant ou invalide
401unauthorizedClé API absente ou invalide
402quota_exceededQuota mensuel épuisé
422analysis_failedImage non exploitable (flou, hors-sujet)
429rate_limitedTrop de requêtes — voir limites ci-dessous
500internal_errorErreur serveur — contactez le support

Limites de taux

Plan Appels/minute Appels/mois
Sandbox (gratuit)550
Usage (0,40 EUR/appel)20Illimite
White Label (299 EUR/mois)601 000
White Label Pro (699 EUR/mois)200Illimite

Plans API

Accès sandbox gratuit pour tester l'intégration. Facturation à l'usage ou forfait mensuel white label.

Sandbox
0 EUR/mois
Pour tester et développer votre intégration.
  • 50 appels/mois
  • Accès aux 5 endpoints
  • Documentation complète
  • Support email
Usage
0,40 EUR/appel
Facturation à l'acte. Pas d'engagement mensuel.
  • Volume illimité
  • Volume 500+ : 0,25 EUR/appel
  • SLA 99,5 %
  • Support prioritaire
White Label
299 EUR/mois
Votre marque, votre expérience. 1 000 appels inclus.
  • PDF sans mention Aegis
  • Webhook temps réel
  • Onboarding technique dédié
  • SLA 99,9 %
White Label Pro
699 EUR/mois
Volume illimité, support dédié, co-marketing.
  • Appels illimités
  • Personnalisation prompts IA
  • Compte commercial dédié
  • Co-marketing possible

Accès partenaire API

L'API est en bêta privée. Écrivez-nous pour un accès sandbox en 24h.

Demander l'accès En savoir plus