Verae

Documentation API

Verae expose une API REST versionnée pour la vérification d'âge (sessions one-shot, Verae ID, distributeurs et e-commerce).

URL de base

https://api.verae.bgws.fr

Préfixe des routes : /v1. Exemple santé : https://api.verae.bgws.fr/v1/health.

Authentification

  • OAuth2 client credentials — POST /v1/oauth/token → JWT (scopes)
  • Clé API — header x-api-key, format vk_<prefix>_<secret>

Scopes usuels :

  • verification:create / verification:read
  • credential:validate

Flux de vérification

  1. POST /v1/verification/sessions — crée une session
  2. POST /v1/verification/sessions/:id/document— document d'identité
  3. POST /v1/verification/sessions/:id/face — selfie
  4. POST /v1/verification/sessions/:id/verdict — verdict

Intégrations

Guides marchands et connecteurs e-commerce : contactez contact@verae.frpour l'accès partenaire (WooCommerce, PrestaShop, Shopify, Odoo, distributeurs).

OpenAPI interactive

L'UI Swagger (/v1/docs) est disponible hors production uniquement, pour limiter l'exposition de la surface d'API.