API de Registro de Áudio

Aviso

Essa API está em estágio experimental de desenvolvimento

A API de registro de áudio permite recuperar quantos segundos de áudio foram transcritos em determinado momento.

Parâmetros suportados

  • start_date: Data de inicio (maior ou igual).
  • end_date: Data de fim (menor que).
  • control: Arquivos finalizados ou com falha (FINISHED/FAILED).
  • batch: Nome do lote

Formato do campo de data YYYYMMDDHHmm, sendo:

  • YYYY: Ano
  • MM: Mês
  • DD: Dia do mês
  • HH: Hora (0 a 23)
  • mm: Minutos (0 a 59)

Aviso

A data utliza o fuso horário UTC (Tempo Universal Coordenado).

Aviso

A data é do momento em que o arquivo foi FINALIZADO e não do momento que foi feito o upload ou start.

Resumo do Registro de Áudio

Retorna um resumo do consumo de segundos.

Requisição

GET /trd/audioregister/summary

Exemplos

  1. Chamada REST:

Exemplo para retornar áudios finalizados com sucesso.

curl -X GET 'http://localhost:8080/trd/audioregister/summary?control=FINISHED'

Resultado JSON:

{
  "count":7,
  "duration":123.5
}

Retornou 7 arquivos com 123,5 segundos de áudio.

  1. Chamada REST:

Exemplo para retornar áudios finalizados com sucesso do mês de janeiro de 2020.

curl -X GET 'http://localhost:8080/trd/audioregister/summary?control=FINISHED&start_date=202001010000&end_date=202002010000'

{
  "count":7,
  "duration":123
}

Lista Registro de Áudio

Retorna uma lista com detalhes do registro de áudio.

Requisição

GET /trd/audioregister

Exemplos

  1. Chamada REST:

Exemplo para retornar áudios finalizados com sucesso.

curl -X GET 'http://localhost:8080/trd/audioregister?control=FINISHED'

Resultado JSON:

[
    {
        "_id": {
            "$oid": "5edd89afb21cc8fe8c44f940"
        },
        "audiofile_id": {
            "$oid": "5edd88d94254ae684468dd04"
        },
        "filename": "audio-teste.wav",
        "status": "RECOGNIZED",
        "control": "FINISHED",
        "channels": 1,
        "duration": 3.817,
        "batch": "example",
        "create_date": {
            "$date": 1591577007004
        },
        "md5": "3edbe82a21f91a784e1aae1729015450"
    }
]
  1. Chamada REST:

Exemplo para retornar áudios finalizados com sucesso do mês de junho de 2020.

curl -X GET 'http://localhost:8080/trd/audioregister?control=FINISHED&start_date=202006010000&end_date=202007010000'

Resultado JSON:

[
    {
        "_id": {
            "$oid": "5edd89afb21cc8fe8c44f940"
        },
        "audiofile_id": {
            "$oid": "5edd88d94254ae684468dd04"
        },
        "filename": "audio-teste.wav",
        "status": "RECOGNIZED",
        "control": "FINISHED",
        "channels": 1,
        "duration": 3.817,
        "batch": "example",
        "create_date": {
            "$date": 1591577007004
        },
        "md5": "3edbe82a21f91a784e1aae1729015450"
    }
]