Aegis Chantier  / API Reference
Demander l'acces Essai gratuit
v1.0 — Disponible en beta prive

API Aegis Chantier

Integrez la generation de devis BTP par IA directement dans votre logiciel. Photo du chantier + description vocale — devis structure JSON ou PDF Factur-X en moins de 2 minutes.

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

Authentification

Toutes les requetes sont authentifiees via une cle API transmise dans l'en-tete HTTP Authorization.

Cle API requise

Ajoutez Authorization: Bearer YOUR_API_KEY a chaque requete. Obtenez votre cle en ecrivant a 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 generation de devis, l'export PDF, la consultation de tarifs materiaux, l'OCR de factures fournisseur et le health check.

POST /v1/quotes/generate Generer un devis depuis photo et/ou voix ▼

Envoie une photo de chantier et/ou une description textuelle ou vocale. L'IA analyse les elements visibles, deduit les postes de travaux et retourne un devis structure avec lignes de prix, quantites estimees et total HT/TTC.

Corps de la requete — 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 (utilisee 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 Generer le PDF Factur-X ▼

Genere et retourne le PDF du devis au format Factur-X (norme EN 16931), conforme a l'obligation de facturation electronique 2026. La reponse est le binaire PDF — Content-Type: application/pdf.

Parametre 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 materiaux ▼

Retourne les prix unitaires de reference pour un materiau ou une prestation BTP. Base de donnees de tarifs regionalisee, actualisee mensuellement.

Parametres de requete
ParametreTypeRequisDescription
q string requis Terme de recherche (ex: "chauffe-eau", "m2 peinture")
trade string optionnel Filtre par corps de metier
region string optionnel Code region INSEE (ex: "75" = Paris)
POST /v1/ocr/invoice OCR facture fournisseur ▼

Extrait les donnees structurees d'une facture fournisseur (PDF ou image). Utile pour les flux achat/comptabilite 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 operationnel 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_requestParametre manquant ou invalide
401unauthorizedCle API absente ou invalide
402quota_exceededQuota mensuel epuise
422analysis_failedImage non exploitable (flou, hors-sujet)
429rate_limitedTrop de requetes — 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

Acces sandbox gratuit pour tester l'integration. Facturation a l'usage ou forfait mensuel white label.

Sandbox
0 EUR/mois
Pour tester et developper votre integration.
  • 50 appels/mois
  • Acces aux 5 endpoints
  • Documentation complete
  • Support email
Usage
0,40 EUR/appel
Facturation a l'acte. Pas d'engagement mensuel.
  • Volume illimite
  • Volume 500+ : 0,25 EUR/appel
  • SLA 99,5 %
  • Support prioritaire
White Label
299 EUR/mois
Votre marque, votre experience. 1 000 appels inclus.
  • PDF sans mention Aegis
  • Webhook temps reel
  • Onboarding technique dedié
  • SLA 99,9 %
White Label Pro
699 EUR/mois
Volume illimite, support dédié, co-marketing.
  • Appels illimites
  • Personnalisation prompts IA
  • Compte commercial dedie
  • Co-marketing possible

Acces partenaire API

L'API est en beta privee. Ecrivez-nous pour un acces sandbox en 24h.

Demander l'acces En savoir plus