{"openapi":"3.0.0","info":{"title":"LegalSphere 360 AI\u2122 \u2014 API REST Officielle","version":"1.0.0","description":"API REST s\u00e9curis\u00e9e pour l'interop\u00e9rabilit\u00e9 des cabinets d'avocats et directions juridiques. Permet la gestion compl\u00e8te des clients, dossiers contentieux\/conseil, facturation, actes juridiques, et services d'intelligence artificielle souveraine (RAG, analyse de risques contractuels, synth\u00e8ses).","contact":{"name":"Support D\u00e9veloppeurs LegalSphere","email":"dev@legalsphere.ai"}},"servers":[{"url":"https:\/\/legalsphere.online\/api\/v1","description":"Serveur d'API Principal (v1)"}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"Sanctum Token","description":"Entrez votre jeton d'acc\u00e8s Bearer obtenu via \/auth\/token"}}},"security":[{"BearerAuth":[]}],"paths":{"\/auth\/token":{"post":{"tags":["Authentification"],"summary":"Obtenir un jeton d'acc\u00e8s API Sanctum","security":[],"requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","required":["email","password"],"properties":{"email":{"type":"string","example":"contact@avocat-demo.com"},"password":{"type":"string","example":"password123"},"device_name":{"type":"string","example":"ERP-Integration"}}}}}},"responses":{"200":{"description":"Jeton d'acc\u00e8s Bearer \u00e9mis avec succ\u00e8s."},"401":{"description":"Identifiants invalides."}}}},"\/auth\/me":{"get":{"tags":["Authentification"],"summary":"Informations de l'utilisateur et du cabinet actif","responses":{"200":{"description":"Profil utilisateur et m\u00e9tadonn\u00e9es du tenant."}}}},"\/clients":{"get":{"tags":["Clients"],"summary":"Liste des clients du cabinet","parameters":[{"name":"search","in":"query","schema":{"type":"string"},"description":"Recherche textuelle"},{"name":"type","in":"query","schema":{"type":"string","enum":["individual","company"]},"description":"Personne physique ou morale"},{"name":"status","in":"query","schema":{"type":"string","enum":["active","prospect","inactive"]}}],"responses":{"200":{"description":"Liste pagin\u00e9e des clients."}}},"post":{"tags":["Clients"],"summary":"Cr\u00e9ation d'un nouveau client","requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","required":["name","type"],"properties":{"name":{"type":"string","example":"Banque Panafricaine SA"},"type":{"type":"string","enum":["individual","company"],"example":"company"},"email":{"type":"string","example":"contact@banquepanaf.com"},"phone":{"type":"string","example":"+242 06 000 0000"},"rccm_number":{"type":"string","example":"CG-BZV-01-2024-B14-00123"}}}}}},"responses":{"201":{"description":"Client cr\u00e9\u00e9 avec succ\u00e8s."}}}},"\/clients\/{id}":{"get":{"tags":["Clients"],"summary":"Consulter la fiche client et ses dossiers","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Fiche client compl\u00e8te."},"404":{"description":"Client introuvable."}}},"put":{"tags":["Clients"],"summary":"Mettre \u00e0 jour un client","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Client mis \u00e0 jour."}}}},"\/cases":{"get":{"tags":["Dossiers Juridiques"],"summary":"Liste des dossiers du cabinet","parameters":[{"name":"search","in":"query","schema":{"type":"string"}},{"name":"workflow_state","in":"query","schema":{"type":"string"}},{"name":"client_id","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"Liste pagin\u00e9e des dossiers."}}},"post":{"tags":["Dossiers Juridiques"],"summary":"Ouverture d'un nouveau dossier juridique","requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","required":["client_id","title"],"properties":{"client_id":{"type":"integer","example":1},"title":{"type":"string","example":"Litige Recouvrement Cr\u00e9ance Commerciale"},"legal_domain":{"type":"string","example":"Droit des Affaires & OHADA"},"court":{"type":"string","example":"Tribunal de Commerce"},"opponent_name":{"type":"string","example":"Soci\u00e9t\u00e9 Alpha Transit"},"criticality":{"type":"string","enum":["low","normal","high","urgent"],"example":"urgent"}}}}}},"responses":{"201":{"description":"Dossier cr\u00e9\u00e9."}}}},"\/cases\/{id}":{"get":{"tags":["Dossiers Juridiques"],"summary":"D\u00e9tails d'un dossier, calendrier et audiences","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Dossier complet."}}}},"\/cases\/{id}\/transition":{"post":{"tags":["Dossiers Juridiques"],"summary":"Faire avancer l'\u00e9tape de proc\u00e9dure juridique","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","required":["state"],"properties":{"state":{"type":"string","enum":["nouveau","analyse","instruction","negociation","plaidoirie","delibere","execution","cloture","archive"],"example":"instruction"}}}}}},"responses":{"200":{"description":"\u00c9tape mise \u00e0 jour."}}}},"\/invoices":{"get":{"tags":["Facturation"],"summary":"Liste des factures et honoraires","parameters":[{"name":"status","in":"query","schema":{"type":"string","enum":["draft","sent","paid","overdue"]}},{"name":"client_id","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"Factures."}}},"post":{"tags":["Facturation"],"summary":"\u00c9mission d'une facture d'honoraires avec d\u00e9compte","requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","required":["client_id","items"],"properties":{"client_id":{"type":"integer","example":1},"items":{"type":"array","items":{"type":"object","required":["description","quantity","unit_price"],"properties":{"description":{"type":"string","example":"R\u00e9daction assignation au fond"},"quantity":{"type":"number","example":3.5},"unit_price":{"type":"number","example":75000}}}}}}}}},"responses":{"201":{"description":"Facture \u00e9mise."}}}},"\/invoices\/{id}\/pay":{"post":{"tags":["Facturation"],"summary":"Comptabiliser un r\u00e8glement d'honoraires","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","required":["amount","payment_method"],"properties":{"amount":{"type":"number","example":250000},"payment_method":{"type":"string","example":"virement"},"reference":{"type":"string","example":"VIR-2026-9988"}}}}}},"responses":{"200":{"description":"Paiement enregistr\u00e9."}}}},"\/documents":{"get":{"tags":["Documents"],"summary":"Liste des pi\u00e8ces juridiques","responses":{"200":{"description":"Actes et documents."}}},"post":{"tags":["Documents"],"summary":"T\u00e9l\u00e9verser un document ou contrat","requestBody":{"required":true,"content":{"multipart\/form-data":{"schema":{"type":"object","required":["name","file"],"properties":{"name":{"type":"string","example":"Protocole_Accord.pdf"},"file":{"type":"string","format":"binary"},"legal_case_id":{"type":"integer"},"category":{"type":"string","enum":["contract","evidence","court_order","pleading","correspondence","invoice","other"]}}}}}},"responses":{"201":{"description":"Document t\u00e9l\u00e9vers\u00e9 avec succ\u00e8s."}}}},"\/ai\/summarize-case":{"post":{"tags":["Intelligence Artificielle"],"summary":"G\u00e9n\u00e9rer une synth\u00e8se IA analytique d'un dossier","requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","required":["legal_case_id"],"properties":{"legal_case_id":{"type":"integer","example":1}}}}}},"responses":{"200":{"description":"Synth\u00e8se juridique g\u00e9n\u00e9r\u00e9e."}}}},"\/ai\/rag-search":{"post":{"tags":["Intelligence Artificielle"],"summary":"Interrogation s\u00e9mantique RAG sur la jurisprudence et les archives du cabinet","requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","required":["question"],"properties":{"question":{"type":"string","example":"Quel est le d\u00e9lai de prescription pour une action en recouvrement commercial sous l'OHADA ?"},"legal_case_id":{"type":"integer","example":null}}}}}},"responses":{"200":{"description":"R\u00e9ponse juridique document\u00e9e avec sources et citations exactes."}}}},"\/ai\/contract-audit":{"post":{"tags":["Intelligence Artificielle"],"summary":"Audit automatique de contrat & matrice des risques","requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","required":["document_id"],"properties":{"document_id":{"type":"integer","example":1}}}}}},"responses":{"201":{"description":"Analyse contractuelle, extraction des clauses et matrice des risques."}}}}}}