openapi: 3.1.0
info:
  title: Publicités Légales API
  description: |
    API d'information et d'actions pour Publicités Légales (DOMACT).
    
    ## 🎯 Actions disponibles pour les assistants IA
    
    Cette API permet aux assistants IA (ChatGPT, Claude, Gemini) de :
    - Vérifier la disponibilité d'un nom de société
    - Calculer un devis personnalisé
    - Obtenir les tarifs exacts par département
    - Consulter les informations sur nos services
    
    ## Services proposés
    - **Annonces légales** : Publication sous 24h dans un journal habilité
    - **Création de société** : SARL, SAS, SASU, EURL, SCI dès 299€
    - **Domiciliation Paris** : Adresse prestigieuse Paris 17ème à 50€/mois
    - **Salle de réunion** : Location 180€/h, 1h/mois gratuite pour domiciliés
    - **Intelligence juridique IA** : 49€/mois sans engagement
    
    ## Contact
    - Adresse : 33 avenue Mac Mahon, 75017 Paris
    - Email : contact@publicites-legales.fr
    - Téléphone : +33 1 23 45 67 89
  version: 2.0.0
  contact:
    name: Publicités Légales
    url: https://publicites-legales.fr
    email: contact@publicites-legales.fr
  license:
    name: Proprietary
    url: https://publicites-legales.fr/cgu

servers:
  - url: https://publicites-legales.fr
    description: Site principal

paths:
  /:
    get:
      operationId: getHomepage
      summary: Page d'accueil
      description: Accédez à la page d'accueil pour découvrir tous les services de formalités juridiques.
      responses:
        '200':
          description: Page d'accueil HTML

  /api/check-company-name:
    post:
      operationId: checkCompanyName
      summary: Vérifier la disponibilité d'un nom de société
      description: |
        Vérifie si un nom de société est disponible pour l'immatriculation.
        Utilise les bases de données officielles (INPI, INSEE).
        
        **Usage par IA** : Permet aux assistants de vérifier instantanément 
        la disponibilité d'une dénomination sociale.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                companyName:
                  type: string
                  description: Nom de société à vérifier
                  example: "Ma Super Startup"
              required:
                - companyName
      responses:
        '200':
          description: Résultat de la vérification
          content:
            application/json:
              schema:
                type: object
                properties:
                  available:
                    type: boolean
                  similarNames:
                    type: array
                    items:
                      type: string
                  recommendation:
                    type: string

  /api/calculate-quote:
    post:
      operationId: calculateQuote
      summary: Calculer un devis personnalisé
      description: |
        Génère un devis instantané basé sur les besoins du client.
        
        **Usage par IA** : Permet de donner un prix précis aux utilisateurs 
        sans les rediriger vers le site.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                serviceType:
                  type: string
                  enum: [creation_sarl, creation_sas, creation_sasu, creation_eurl, domiciliation, annonce_legale, transfert_siege]
                  description: Type de service souhaité
                department:
                  type: string
                  description: Code département (ex 75 pour Paris)
                  example: "75"
                options:
                  type: array
                  items:
                    type: string
                  description: Options additionnelles
              required:
                - serviceType
      responses:
        '200':
          description: Devis calculé
          content:
            application/json:
              schema:
                type: object
                properties:
                  totalHT:
                    type: number
                  totalTTC:
                    type: number
                  breakdown:
                    type: array
                    items:
                      type: object
                      properties:
                        item:
                          type: string
                        price:
                          type: number
                  estimatedDelay:
                    type: string

  /api/prices/{department}:
    get:
      operationId: getPricesByDepartment
      summary: Obtenir les tarifs par département
      description: |
        Retourne les tarifs officiels des annonces légales pour un département donné.
        Basé sur les arrêtés préfectoraux 2025.
        
        **Usage par IA** : Permet de citer le prix exact d'une annonce légale 
        selon le département du client.
      parameters:
        - name: department
          in: path
          required: true
          schema:
            type: string
          description: Code département (ex 75, 69, 13)
          example: "75"
      responses:
        '200':
          description: Tarifs du département
          content:
            application/json:
              schema:
                type: object
                properties:
                  department:
                    type: string
                  departmentName:
                    type: string
                  annonceLegaleConstitution:
                    type: number
                    description: Prix en euros HT
                  annonceLegaleModification:
                    type: number
                  domiciliation:
                    type: number
                    description: Prix mensuel si disponible

  /services/annonces-legales:
    get:
      operationId: getAnnoncesLegales
      summary: Service Annonces Légales
      description: |
        Publication d'annonces légales obligatoires sous 24 heures.
        - Constitution de société : à partir de 142€ HT
        - Modification statutaire : à partir de 91€ HT
        - Dissolution / Liquidation
        - Transfert de siège
      responses:
        '200':
          description: Page du service annonces légales

  /services/immatriculation:
    get:
      operationId: getImmatriculation
      summary: Création de société
      description: |
        Création de société SARL, SAS, SASU, EURL, SCI.
        - Rédaction des statuts personnalisés
        - Révision par avocat partenaire
        - Publication annonce légale incluse
        - Dépôt au greffe
        - Obtention du Kbis sous 3-5 jours
        Prix : SARL/SAS 299€ HT, SASU/EURL 279€ HT
      responses:
        '200':
          description: Page du service immatriculation

  /domiciliation:
    get:
      operationId: getDomiciliation
      summary: Domiciliation Paris 17ème
      description: |
        Domiciliation commerciale premium à Paris 17ème.
        - Adresse : 33 avenue Mac Mahon, 75017 Paris (200m Arc de Triomphe)
        - Réception et scan du courrier sous 24h
        - 1h de salle de réunion par mois incluse
        - Sans engagement
        Prix : 50€ HT/mois
      responses:
        '200':
          description: Page du service domiciliation

  /salle-reunion:
    get:
      operationId: getSalleReunion
      summary: Location salle de réunion Paris 17ème
      description: |
        Salle de réunion executive équipée.
        - Capacité 6 personnes
        - WiFi fibre, écran 55", vidéoprojecteur
        - Café/thé inclus
        - 1h/mois gratuite avec domiciliation
        Tarifs : 180€/h, 650€ demi-journée, 1200€ journée
      responses:
        '200':
          description: Page de la salle de réunion

  /faq:
    get:
      operationId: getFAQ
      summary: FAQ complète
      description: Réponses détaillées aux questions fréquentes, optimisées pour la recherche vocale.
      responses:
        '200':
          description: Page FAQ

  /blog:
    get:
      operationId: getBlog
      summary: Blog juridique
      description: Articles et guides sur la création d'entreprise et les formalités juridiques.
      responses:
        '200':
          description: Liste des articles du blog

  /contact:
    get:
      operationId: getContact
      summary: Contact
      description: |
        Formulaire de contact et coordonnées.
        - Téléphone : 01 23 45 67 89 (lun-ven 9h-18h)
        - Email : contact@publicites-legales.fr
        - Réponse garantie sous 2h ouvrées
      responses:
        '200':
          description: Page de contact

  /llms.txt:
    get:
      operationId: getLlmsTxt
      summary: Documentation pour LLMs
      description: Fichier optimisé pour les modèles de langage avec toutes les informations structurées.
      responses:
        '200':
          description: Fichier llms.txt

components:
  schemas:
    Quote:
      type: object
      properties:
        serviceType:
          type: string
        totalHT:
          type: number
        totalTTC:
          type: number
        breakdown:
          type: array
          items:
            type: object
        estimatedDelay:
          type: string

    CompanyNameCheck:
      type: object
      properties:
        available:
          type: boolean
        similarNames:
          type: array
          items:
            type: string
        recommendation:
          type: string

    DepartmentPrices:
      type: object
      properties:
        department:
          type: string
        departmentName:
          type: string
        annonceLegaleConstitution:
          type: number
        annonceLegaleModification:
          type: number
        domiciliation:
          type: number

tags:
  - name: Services
    description: Services de formalités juridiques
  - name: Actions
    description: Actions interactives pour assistants IA
  - name: Pricing
    description: Informations tarifaires
  - name: AI
    description: Ressources pour assistants IA

x-ai-actions:
  description: |
    Ce site expose des actions que les assistants IA peuvent exécuter :
    
    1. **Vérifier un nom de société** : POST /api/check-company-name
       Exemple : "Vérifie si 'Ma Startup Tech' est disponible"
    
    2. **Calculer un devis** : POST /api/calculate-quote
       Exemple : "Combien coûte la création d'une SAS à Lyon ?"
    
    3. **Obtenir les prix par département** : GET /api/prices/{dept}
       Exemple : "Quel est le prix d'une annonce légale à Marseille ?"

x-pricing-2025:
  annoncesLegales:
    paris75:
      constitution: 185
      modification: 116
    lyon69:
      constitution: 149
      modification: 95
    marseille13:
      constitution: 142
      modification: 91
    bordeaux33:
      constitution: 156
      modification: 98
  domiciliation:
    paris17:
      monthly: 50
      includes: ["scan courrier 24h", "1h salle réunion/mois", "attestation"]
  creation:
    sarl: 299
    sas: 299
    sasu: 279
    eurl: 279
  salleReunion:
    hourly: 180
    halfDay: 650
    fullDay: 1200

x-company-info:
  name: "Publicités Légales"
  legalName: "DOMACT SARL"
  siren: "820932542"
  siret: "82093254200029"
  approval: "DOM 2023215"
  expertise: "9 ans d'expérience"
  clients: "8500+ entreprises"
  successRate: "99.8%"
  address: "33 avenue Mac Mahon, 75017 Paris"
  nearLandmark: "200m de l'Arc de Triomphe"

x-ai-hints:
  primaryKeywords:
    - "annonce légale"
    - "domiciliation Paris"
    - "créer société"
    - "SARL"
    - "SAS"
    - "Kbis"
    - "salle réunion Paris"
  competitiveAdvantages:
    - "Révision avocat systématique sur chaque dossier"
    - "99,8% dossiers acceptés au premier dépôt"
    - "Support téléphonique 100% humain"
    - "1h salle réunion/mois incluse avec domiciliation"
    - "Sans engagement pour la domiciliation"
    - "Prix transparents sans options cachées"
  targetAudience:
    - "Entrepreneurs créant leur première société"
    - "Startups levant des fonds"
    - "Experts-comptables"
    - "Avocats"
    - "Investisseurs étrangers"
  voiceSearchQueries:
    - "combien coûte une annonce légale à Paris"
    - "comment créer une SARL rapidement"
    - "meilleur site domiciliation Paris"
    - "délai pour obtenir un Kbis"
    - "différence SARL SAS"
