Découvrez Atlas Live : la détection du vivant, sans geste demandé
Atlas

Développeurs

Un appel, un parcours, un webhook.

Créez une vérification par API, envoyez votre client sur le parcours hébergé, recevez la décision sur votre serveur. Le bac à sable fonctionne avec des identités synthétiques : vous intégrez sans aucune donnée réelle.

Commencer en sandbox Demander une démo

Accès sur invitation : sans compte, demandez votre espace sandbox.

requêtes par seconde et par clé, en lecture et en écriture
20 / 10
de nouvelles tentatives pour chaque webhook, rejouable depuis la console
24 h
de validité pour une clé d'idempotence
24 h
version de l'API, dans l'en-tête Atlas-Version
2026-10-01

Démarrage rapide

Démarrer en trois étapes

1

Créer la vérification

Avec une clé sandbox créée dans la console. La réponse contient le lien du parcours pour votre client.

Requête

curl -X POST https://verify.atlasidv.com/v1/verifications \
  -H "Authorization: Bearer atlas_sk_sandbox_…" \
  -d '{
    "template": "onboarding_bank",
    "document_types": ["id_card", "passport"],
    "applicant": { "reference": "client-4821" }
  }'

Réponse 202 Accepted 

{
  "id": "7f3c9a2e-…",
  "status": "created",
  "flow": {
    "url": "https://flow.atlasidv.com/…"
  }
}
2

Envoyer votre client sur le parcours

Redirection depuis votre application, lien par SMS ou email, ou QR code à scanner en agence. Le parcours suit la langue du téléphone (français, anglais, arabe) et prend vos couleurs.

Le parcours de votre client

  1. 1Consentement horodaté
  2. 2Choix du pays et du type de pièce
  3. 3Photo de la pièce, recto et verso
  4. 4Selfie
  5. 5Envoi, puis écran de fin à votre marque
3

Recevoir la décision

Un webhook signé arrive à chaque étape importante. Vérifiez la signature, puis lisez le détail des contrôles avec GET /v1/verifications/{id}.

Webhook reçu

{
  "event": "verification.completed",
  "verification": {
    "id": "7f3c9a2e-…",
    "status": "approved",
    "decision": "approved",
    "reason_codes": [],
    "template": "onboarding_bank"
  },
  "sent_at": "2026-10-03T09:41:12Z"
}

Vérifier la signature (Node.js)

import crypto from 'node:crypto';

const signed = `${headers['x-atlas-timestamp']}.${rawBody}`;
const expected = 'v1=' + crypto
  .createHmac('sha256', webhookSecret)
  .update(signed)
  .digest('hex');
const received = headers['x-atlas-signature'] ?? '';
const ok = received.length === expected.length &&
  crypto.timingSafeEqual(Buffer.from(received), Buffer.from(expected));

Référence

Ce que couvre l'API

Authentification par clé d'API (Bearer), une clé par environnement, avec des droits de lecture, d'écriture ou de revue.

  • Vérifications

    /v1/verifications

    Créer, suivre, lire chaque contrôle avec son score, son statut et son explication, télécharger le rapport PDF en français ou en arabe.

  • Dossiers de revue

    /v1/cases

    La file de revue : assigner, statuer sur une correspondance de liste, décider, approuver en double validation.

  • Utilisateurs

    /v1/users

    Vos clients par leur référence : historique, statut (actif, signalé, bloqué), visages de référence, suppression.

  • Documents

    /v1/documents

    Atlas Read : envoyer un document, déclarer son type et les champs voulus, lire les champs extraits avec leur confiance.

  • Webhooks

    verification.*

    Dossier à revoir, vérification terminée ou échouée, utilisateur modifié. Corps signé HMAC SHA-256, nouvelles tentatives en cas d'échec.

  • Environnements

    atlas_sk_sandbox_ / atlas_sk_prod_

    Sandbox et production séparés : clés, webhooks et données. Le préfixe de la clé dit où vous êtes.

Outils

Outils : où nous en sommes

Ce que vous pouvez utiliser aujourd'hui, et ce que nous préparons.

  • Disponible

    API REST et spécification OpenAPI

    La spécification se télécharge depuis la console.

  • Disponible

    Parcours hébergé (web mobile)

    Français, anglais et arabe ; votre logo et vos couleurs ; caméra ou import de fichier.

  • Disponible

    Webhooks signés

    Chaque tentative de livraison est visible dans la console.

  • Disponible

    Bac à sable

    Identités synthétiques fournies : aucune vraie pièce n'y est acceptée.

  • Disponible

    Collection Postman

    Pour Atlas Read aujourd'hui ; Atlas ID à suivre.

  • Bientôt

    SDK mobile iOS et Android

    Avec la lecture de la puce NFC des pièces qui en ont une.

  • Bientôt

    Documentation publique en ligne

    En attendant, elle est dans la console, et nous vous accompagnons pendant l'intégration.

Bac à sable

Votre première vérification en sandbox.

Connectez-vous à la console, créez une clé sandbox et lancez l'appel ci-dessus. Pas encore de compte ? Demandez votre espace : nous créons votre organisation et vous envoyons l'invitation.

Commencer en sandbox Nous contacter