MV sistemas

MV sistemas Agendamento API

Criação e atualização de status de agendamentos

GitHub OpenAPI

Operations 2

POST /v1/performance-schedules/scheduling Criar agendamento a partir de um Agendamento de performance #
PUT /v1/performance-schedules/scheduling/status Atualizar status do agendamento #

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/mv-sistemas/refs/heads/main/openapi/mv-sistemas-agendamento-api-openapi.yml

Other Resources

🔗
APIsJSON
https://raw.githubusercontent.com/api-evangelist/mv-sistemas/refs/heads/main/apis.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-agendamento-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

mv-sistemas-agendamento-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Clinic Connect - de performance Agendamento API
  description: 'API do módulo Clinic Connect para listagem de Agendamento de performance e operações de agendamento.

    Base path: `/clinic/clinic-connect`

    '
  version: 1.0.0
servers:
- url: https://api.globalhealth.mv/clinic-connect/api/
  description: Ambiente de PRODUÇÃO
- url: https://api.globalhealth.mv/hml/clinic-connect/api/
  description: Ambiente de HOMOLOGAÇÃO
- url: https://api.globalhealth.mv/qa/clinic-connect/api/
  description: Ambiente de QA
security:
- x-api-key: []
tags:
- name: Agendamento
  description: Criação e atualização de status de agendamentos
paths:
  /v1/performance-schedules/scheduling:
    post:
      tags:
      - Agendamento
      summary: Criar agendamento a partir de um Agendamento de performance
      description: 'Cria um agendamento (Schedules) vinculado a um Agendamento de performance disponível.

        É obrigatório informar `id` ou `externalId` do Agendamento de performance, além de patient, insurance e termCbo.

        O slot deve estar disponível (não ocupado).

        '
      operationId: createScheduling
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PerformanceScheduleSchedulingDTO'
      responses:
        '201':
          description: Agendamento criado com sucesso
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Schedules'
        '400':
          description: Requisição inválida (dados faltando, slot ocupado, etc.)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Agendamento de performance não encontrado ou não disponível
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /v1/performance-schedules/scheduling/status:
    put:
      tags:
      - Agendamento
      summary: Atualizar status do agendamento
      description: 'Altera o status do agendamento (Schedules) vinculado a um Agendamento de performance.

        O Agendamento de performance deve estar ocupado (ter Schedules vinculado).

        Para status CANCELLED: não é permitido se já existir atendimento; ao cancelar, o slot é liberado e é criado um registro de cancelamento (PATIENT_CANCELLED).

        '
      operationId: updateSchedulingStatus
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PerformanceScheduleSchedulingStatusDTO'
      responses:
        '200':
          description: Status atualizado com sucesso
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Schedules'
        '400':
          description: Requisição inválida (status inválido, cancelamento com atendimento existente, etc.)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Agendamento de performance não encontrado ou não ocupado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Schedules:
      type: object
      description: Entidade de agendamento retornada na criação e na atualização de status
      properties:
        id:
          type: integer
          format: int64
        date:
          type: string
          format: date
        startTime:
          type: string
          format: time
        predictionEndTime:
          type: string
          format: time
        schedulingStatus:
          type: string
        observation:
          type: string
        patient:
          type: object
        clinic:
          type: object
        employee:
          type: object
        insurance:
          type: object
        createdDate:
          type: string
          format: date-time
        lastModifiedDate:
          type: string
          format: date-time
    Error:
      type: object
      properties:
        error:
          type: string
          description: Tipo do erro
        message:
          type: string
          description: Mensagem descritiva do erro (pode vir do i18n)
        details:
          type: object
          additionalProperties: true
    PerformanceScheduleSchedulingDTO:
      type: object
      description: Request para criar agendamento a partir de um Agendamento de performance
      properties:
        id:
          type: integer
          format: int64
          description: ID do Agendamento de performance (opcional se externalId for informado)
        externalId:
          type: string
          description: External ID do Agendamento de performance (opcional se id for informado)
        insurance:
          $ref: '#/components/schemas/InsuranceCardDTO'
          description: Dados do convênio
        patient:
          $ref: '#/components/schemas/ConnectPatientDTO'
          description: Dados do paciente
        termCbo:
          type: string
          description: Código CBO (termCode) da especialidade
        observation:
          type: string
          description: Observação do agendamento
    InsuranceCardDTO:
      type: object
      description: Dados do convênio/carteirinha
      properties:
        ansCode:
          type: string
        number:
          type: string
        expirationDate:
          type: string
        newborn:
          type: boolean
    PerformanceScheduleSchedulingStatusDTO:
      type: object
      description: Request para atualizar status do agendamento
      properties:
        id:
          type: integer
          format: int64
          description: ID do Agendamento de performance (opcional se externalId for informado)
        externalId:
          type: string
          description: External ID do Agendamento de performance (opcional se id for informado)
        schedulingStatus:
          type: string
          description: Novo status (ex. CANCELLED, CONFIRMED, WAITING, NO_SHOW, ATTENDED)
    ConnectPatientDTO:
      type: object
      description: Dados do paciente (Clinic Connect)
      properties:
        id:
          type: integer
          format: int64
        externalId:
          type: string
        name:
          type: string
        socialName:
          type: string
        birthDate:
          type: string
          description: Data/hora no formato ISO (Joda DateTime)
        cellphone:
          type: string
        email:
          type: string
        identificationType:
          type: string
        identificationNumber:
          type: string
        gender:
          type: string
        mother:
          type: string
        observation:
          type: string
        address:
          type: string
        state:
          type: string
        city:
          type: string
        district:
          type: string
        zipCode:
          type: string
        addressComplement:
          type: string
        addressNumber:
          type: string
  securitySchemes:
    x-api-key:
      type: apiKey
      name: x-api-key
      in: header