> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pro.resocom.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Créer une vérification

> Crée une session de vérification adossée à un workflow et rend l'URL du parcours à transmettre à votre client (e-mail, SMS, ou intégrée à votre tunnel). Appelez cette route depuis votre serveur — jamais depuis un navigateur.



## OpenAPI

````yaml /openapi.json post /api/v1/verifications
openapi: 3.1.0
info:
  title: API Resocom
  version: 1.0.0
  description: >-
    Créer des vérifications d'identité, analyser directement les documents que
    vous détenez déjà, et relire les résultats depuis votre système
    d'information.
servers:
  - url: https://pro.resocom.com
security:
  - cleApi: []
paths:
  /api/v1/verifications:
    post:
      summary: Créer une vérification
      description: >-
        Crée une session de vérification adossée à un workflow et rend l'URL du
        parcours à transmettre à votre client (e-mail, SMS, ou intégrée à votre
        tunnel). Appelez cette route depuis votre serveur — jamais depuis un
        navigateur.
      operationId: creerVerification
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - workflowId
              properties:
                workflowId:
                  type: string
                  description: >-
                    Workflow qui évaluera le document. Listez vos workflows via
                    GET /api/v1/workflows, ou copiez l'identifiant depuis
                    l'onglet Diffusion du workflow dans la plateforme.
                  example: WFL-20260706-BEF798
                externalRef:
                  type: string
                  maxLength: 255
                  description: >-
                    Votre référence de dossier — renvoyée dans chaque webhook et
                    lecture. Posée ici par votre serveur, elle fait autorité.
                  example: DOSSIER-88412
                expiresInMinutes:
                  type: integer
                  minimum: 5
                  maximum: 10080
                  default: 1440
                  description: Validité du lien, de 5 minutes à 7 jours.
      responses:
        '201':
          description: Session créée.
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: Identifiant de la session de parcours.
                    example: 5f2b7c1e-…
                  verificationUrl:
                    type: string
                    description: URL unique à transmettre à votre client.
                    example: https://pro.resocom.com/parcours/verification/PAR-…?s=…
                  externalRef:
                    type:
                      - string
                      - 'null'
                    example: DOSSIER-88412
                  workflowId:
                    type: string
                    example: WFL-20260706-BEF798
                  expiresAt:
                    type: string
                    format: date-time
                    description: Fin de validité du lien.
        '400':
          description: Corps invalide (`issues` détaille les champs).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Erreur'
        '404':
          description: Workflow inconnu — ou d'une autre entreprise.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Erreur'
components:
  schemas:
    Erreur:
      type: object
      properties:
        error:
          type: string
          description: Code d'erreur machine.
          example: invalid_api_key
  securitySchemes:
    cleApi:
      type: http
      scheme: bearer
      bearerFormat: rsk_live_…
      description: >-
        Clé API créée dans Administration → Entreprise → Clés API (licence
        Groupe).

````