MV sistemas

MV sistemas Reconhecimento Facial API

The Reconhecimento Facial API from MV sistemas — 2 operation(s) for reconhecimento facial.

Documentation GitHub OpenAPI

Operations 2

GET /api/v1/face/liveness/start Iniciar o processo da validação de vivacidade da informação biométrica. #

POST /api/v1/face/liveness/finish Finalizar o processo da validação de vivacidade da informação biométrica. #

Specifications

⚙

OpenAPI

https://raw.githubusercontent.com/api-evangelist/mv-sistemas/refs/heads/main/openapi/mv-sistemas-reconhecimento-facial-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/mv-sistemas-reconhecimento-facial-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Reconhecimento Facial API
  version: 3.1.0
  contact:
    email: globalhealth@mv.com.br
  description: Essa documentação descreve a API de reconhecimento facial da [GLOBALHEALTH]() que tem por objetivo fornecer um cadastro unico de faces e disponibilizar o reconhecimento facial destas.
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://api.globalhealth.mv/prod/face-recognition
  description: Ambiente de PRODUÇÃO
- url: https://api-hml.globalhealth.mv/hml/face-recognition
  description: Ambiente de HOMOLOGAÇÃO
security:
- x-api-key: []
tags:
- name: Reconhecimento Facial
paths:
  /api/v1/face/liveness/start:
    get:
      tags:
      - Reconhecimento Facial
      operationId: faceLivenessStartV1
      responses:
        '200':
          description: Sucesso no inicio da validação de vivacidade.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FaceLivenessStartV1Response'
      summary: Iniciar o processo da validação de vivacidade da informação biométrica.
      description: Este endpoint inicia a validação da vivacidade da informação biométrica.
  /api/v1/face/liveness/finish:
    post:
      tags:
      - Reconhecimento Facial
      operationId: faceLivenessFinishV1
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FaceLivenessFinishV1Request'
      responses:
        '200':
          description: Sucesso na finalização da validação de vivacidade.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FaceLivenessFinishV1Response'
      summary: Finalizar o processo da validação de vivacidade da informação biométrica.
      description: Este endpoint finaliza a validação da vivacidade da informação biométrica.
components:
  schemas:
    FaceLivenessFinishV1Request:
      type: object
      properties:
        performFacialRecognition:
          type: boolean
          description: Define se após realizar o processo de validação de vivacidade, realiza o reconhecimento facial. Considerando o valor como true, os campos documentNumber, sharpness, minConfidance e requesterName se tornam obrigatórios
          default: false
          examples:
          - 'true'
          - 'false'
        sessionId:
          type: string
          description: Id da sessão para validação da vivacidade.
          examples:
          - eda90689-a934-41bb-bd1a-4037be4964cd
          - 9a63b237-7897-4602-a39c-d4dd64d7fda3
          - 9a63b237-7897-4602-a39c-d4dd64d7fda3
        documentNumber:
          type: string
          description: Número do documento ao qual se deseja realizar o reconhecimento facial.
          examples:
          - '12345678910'
          - '12345678911'
          - '12345678912'
        sharpness:
          type: number
          description: Percentual de nitidez mínima.
          examples:
          - 0
          - 11.11
          - 54.45423525255
        minConfidance:
          type: number
          description: Percentual de confiança mínima do reconhecimento facial.
          examples:
          - 0
          - 70
          - 95.5
        requesterName:
          type: string
          description: Nome do solicitante que está realizando a ação.
          examples:
          - Dr. olincon
          - Dra. Vanessa
          - Dr. lideson
          - Dr. Angelo
        healthPlanId:
          type: number
          description: Identificador do convênio.
          examples:
          - 11231
          - 2646
          - 553
        healthPlanName:
          type: string
          description: Nome do convênio.
        healthPlanAnsCode:
          type: string
          description: Código ANS do convênio.
      required:
      - performFacialRecognition
      - sessionId
    FaceLivenessFinishV1Response:
      type: object
      properties:
        faceLivenessResults:
          $ref: '#/components/schemas/FaceLivenessFinishV1ResponseFaceLivenessResults'
        recognitionResults:
          $ref: '#/components/schemas/FaceLivenessFinishV1ResponseRecognitionResults'
      required:
      - faceLivenessResults
    FaceLivenessFinishV1ResponseRecognitionResultsQuality:
      type: object
      properties:
        brightness:
          type: number
          description: Percentual de brilho na face.
          examples:
          - 98.1
          - 99.99
          - 67.13
        sharpness:
          type: number
          description: Percentual de nitidez da face.
          examples:
          - 98.1
          - 99.99
          - 67.13
      required:
      - brightness
      - sharpness
    FaceLivenessFinishV1ResponseRecognitionResultsBoudingBox:
      type: object
      properties:
        top:
          type: number
          description: Coordenada superior da caixa delimitadora como proporção da altura geral da imagem.
          examples:
          - 0.17801541090011597
        left:
          type: number
          description: Coordenada esquerda da caixa delimitadora como proporção da largura geral da imagem.
          examples:
          - 0.3142961263656616
        width:
          type: number
          description: Largura da caixa delimitadora como proporção da largura geral da imagem.
          examples:
          - 0.6097581386566162
        height:
          type: number
          description: Altura da caixa delimitadora como proporção da altura geral da imagem.
          examples:
          - 0.5632858276367188
      required:
      - top
      - left
      - width
      - height
    FaceLivenessFinishV1ResponseRecognitionResults:
      type: object
      properties:
        confidence:
          type: string
          description: Percentual de confiança do reconhecimento facial.
        similarity:
          type: string
          description: Percentual de similaridade do reconhecimento facial.
        boundingBox:
          $ref: '#/components/schemas/FaceLivenessFinishV1ResponseRecognitionResultsBoudingBox'
        quality:
          $ref: '#/components/schemas/FaceLivenessFinishV1ResponseRecognitionResultsQuality'
        protocol:
          type: string
          description: Protocolo gerado a partir de uma justificativa ou reconhecimento facial.
      required:
      - confidence
      - similarity
      - boundingBox
      - quality
      - protocol
      - photo
    FaceLivenessFinishV1ResponseFaceLivenessResults:
      type: object
      properties:
        confidence:
          type: number
          description: Percentual de confiança da vivacidade.
      required:
      - confidence
      - photoBase64
    FaceLivenessStartV1Response:
      type: object
      properties:
        sessionId:
          type: string
          description: Id da sessão a ser utilizado para validação da vivacidade.
          examples:
          - eda90689-a934-41bb-bd1a-4037be4964cd
          - 9a63b237-7897-4602-a39c-d4dd64d7fda3
          - 9a63b237-7897-4602-a39c-d4dd64d7fda3
      required:
      - sessionId
  securitySchemes:
    x-api-key:
      type: apiKey
      name: x-api-key
      in: header