API Développeur Enseigne.net

Les clés sont émises par l'équipe Enseigne.net depuis le back-office admin. Elles authentifient toutes les requêtes MCP et certaines routes REST sensibles.

• Format : ens_live_…
• Transmission : header Authorization: Bearer <clé> ou x-api-key: <clé>
• Quotas par défaut : 60 requêtes / minute · 1000 / jour
• Révocable à tout moment côté admin

Le serveur MCP (Model Context Protocol) expose 7 outils aux assistants IA compatibles (ChatGPT, Claude, Gemini, agents internes).

POST https://enseigne.net/api/mcp
Authorization: Bearer ens_live_xxx
Content-Type: application/json
Accept: application/json, text/event-stream

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

Appel d'un outil :

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "search_directory",
    "arguments": { "type": "fabricant", "city_slug": "paris", "limit": 10 }
  }
}

• search_directory

  Rechercher des professionnels publiés (filtres métier, ville, département, compétence, vérifié)

• get_directory_listing

  Récupérer une fiche professionnelle complète par slug ou id

• search_encyclopedia

  Rechercher dans l'encyclopédie de l'enseigne (termes, technologies, matériaux)

• get_encyclopedia_term

  Récupérer un terme complet avec FAQ et termes liés

• search_regulations

  Lister les réglementations publiées (ville, département, région)

• get_city_regulation

  Récupérer la réglementation complète d'une ville (RLP, dimensions, luminance, CERFA, contacts)

• create_contact_request

  Créer une demande de devis ou d'information qualifiée vers un professionnel

Pour les usages simples et indexation, l'API REST publique reste disponible :

GET /api/v1/listings?type=fabricant&city_slug=paris
GET /api/v1/listings/:id
GET /api/v1/encyclopedia
GET /api/v1/encyclopedia/:slug
GET /api/v1/regulations
GET /api/v1/regulations/cities/:slug
GET /api/v1/cities
GET /api/v1/skills

Les écritures (création de demandes de contact) passent par MCP avec clé API authentifiée.

• Aucune donnée privée n'est exposée — uniquement les contenus marqués publiés (RLS appliquée).
• Rate limiting strict par clé (par minute et par jour).
• Validation Zod stricte sur tous les inputs.
• Tous les appels sensibles sont enregistrés dans les audit logs.
• Les clés compromises doivent être révoquées immédiatement depuis le back-office.