Aller au contenu principal
Devis gratuit

Catalogue API RGE-OS

24 endpoints publics, licence CC-BY 4.0. Citez Source : ServicesArtisans.

Spec OpenAPI : JSON / YAML. Spec AsyncAPI : JSON / YAML. Transparence IA : /transparence-ia.

AI

  • AnswerEngine

    betaRalph 19

    POST une requête FR + contexte aides optionnel → réponse orchestrée avec citations, trace, Critic YMYL.

    POST GET /api/v1/askDocs

Streaming

  • AnswerEngine SSE

    betaRalph 28

    POST → text/event-stream. Events: start, groundtruth, chunk, critic, done, error, heartbeat.

    POST GET /api/v1/ask/streamDocs

Aides

  • MaPrimeRénov 2026

    stableRalph 16

    Calculator déterministe MPR. Inputs: geste, menage_categorie, zone, rfr, nb_personnes. CC-BY 4.0.

    GET /api/v1/aides/mpr-bareme

  • CEE 2026

    stableRalph 16

    Calculator déterministe CEE. Inputs: geste, zone_climatique, type_logement, menage_categorie.

    GET /api/v1/aides/cee-bareme

  • Aides cumulability rules

    stableRalph 16

    Règles de cumul MPR + CEE + Eco-PTZ.

    GET /api/v1/aides/cumul-rules

RGE

  • Lookup RGE par SIRET

    stable

    GET ?siret=14 chiffres → fiche RGE complète.

    GET /api/v1/rge/lookup

  • Search RGE par métier + ville

    stable

    GET ?metier=X&ville=Y[&limit=N] → liste paginée.

    GET /api/v1/rge/search

GraphQL

  • GraphQL-as-RPC

    betaRalph 23

    POST {query} → exécute la requête sur les 5 root fields (rgeLookup, rgeSearch, mprBareme, ceeBareme, cumulRules).

    POST GET /api/v1/graphql

KG

  • SPARQL Knowledge Graph

    betaRalph 25

    SPARQL 1.1 subset. GET ?query=... ou POST. Formats: json/csv/tsv/xml.

    GET POST /api/v1/kg/sparql

  • SA-RGE Ontology

    stableRalph 25

    OWL ontology RGE en Turtle ou JSON-LD selon Accept header.

    GET /api/v1/kg/ontology

MCP

  • Model Context Protocol

    betaRalph 11

    JSON-RPC 2.0 server. 6 tools pour agents Claude/Gemini/GPT.

    POST /api/v1/mcp

Webhooks

  • Subscribe webhook

    betaRalph 24

    POST {url, email?, events[]} → 201 {id, secret, api_key}.

    POST /api/v1/webhooks/subscribe

  • Unsubscribe webhook

    betaRalph 24

    DELETE {id, secret}.

    DELETE /api/v1/webhooks/unsubscribe

  • List webhooks

    betaRalph 24

    GET avec Authorization: Bearer <api_key>.

    GET /api/v1/webhooks/list

  • Test webhook delivery

    betaRalph 24

    POST {id, secret, event} → fire mock payload + record delivery.

    POST /api/v1/webhooks/test

Embed

  • RGE search widget

    stableRalph 21

    Iframe-able search box pour intégration tiers (3 lignes HTML).

    GET /embed/rge

Meta

  • OpenAPI 3.1 spec (JSON)

    stableRalph 27

    Single source of truth contract. Postman/Insomnia/Bruno auto-import.

    GET /api/v1/openapi/jsonDocs

  • OpenAPI 3.1 spec (YAML)

    stableRalph 27

    YAML variant.

    GET /api/v1/openapi/yaml

  • AsyncAPI 3.0 spec (JSON)

    stableRalph 30

    Events catalog pour webhooks. EventCatalog / AsyncAPI Studio import.

    GET /api/v1/asyncapi/jsonDocs

  • AsyncAPI 3.0 spec (YAML)

    stableRalph 30

    YAML variant.

    GET /api/v1/asyncapi/yaml

  • Health check (shallow)

    stableRalph 32

    Uptime probe pour monitoring. Toujours 200 si la fonction Vercel répond.

    GET HEAD /api/v1/health

  • Health check (deep)

    stableRalph 32

    Pings Supabase + Upstash + check LLM keys. 503 si fail.

    GET /api/v1/health/deep

SDK

  • @servicesartisans/rge-sdk

    betaRalph 22

    Typed npm client (Node 18+, MIT, zero-dep).

    npm:@servicesartisans/rge-sdk

CLI

  • sa-rge-os CLI

    betaRalph 20

    Node 18+ CLI public (npm install -g sa-rge-os).

    npm:sa-rge-os