Skip to main content

PATCH Salvar URL Pública do Áudio

Salva a URL pública do áudio de uma consulta após o upload para o storage.

Autenticação necessária

Esta rota requer o header Authorization: Bearer {accessToken}

Fluxo de uso

Utilize esta rota após obter a publicUrl retornada pelo endpoint Gerar URL Pré-assinada para Áudio e concluir o upload do arquivo.

Endpoint​

PATCH https://api-dev.imagemais.com.br/api/consultations/{id}/audio-url

Parâmetros​

Path​

CampoTipoObrigatórioDescrição
idnumber✅ID da consulta

Corpo da Requisição (application/json)​

CampoTipoObrigatórioDescrição
urlstring✅URL pública do áudio a ser salva

Requisição​

curl -X 'PATCH' \
  'https://api-dev.imagemais.com.br/api/consultations/1/audio-url' \
  -H 'accept: */*' \
  -H 'Authorization: Bearer {accessToken}' \
  -H 'Content-Type: application/json' \
  -d '{
  "url": "https://storagedev.exemplo.com.br/audio.mp3"
}'

Respostas​

200 Sucesso​

Retorna o registro do arquivo de áudio salvo na consulta.

{
  "id": 320,
  "url": "https://storagedev.exemplo.com.br/audio.mp3",
  "fileType": "consultation-audio",
  "name": "Áudio da pré-consulta da data: 19/05/2026 08:36:42",
  "accountId": null,
  "createdAt": "2026-05-19T11:36:42.338Z",
  "updatedAt": "2026-05-19T11:36:42.339Z",
  "deletedAt": null
}

500 Consulta não encontrada ou inválida​

Retornado quando o id informado na URL não existe ou é inválido.

{
  "statusCode": 500,
  "message": "Erro ao salvar URL do áudio",
  "error": "Internal Server Error"
}

403 Sem Permissão​

Retornado quando o usuário autenticado não possui permissão para salvar a URL do áudio.

{
  "statusCode": 403,
  "message": "Forbidden resource"
}