Skip to main content
POST
Consulte o consumo de minutos de tradução e sincronização labial e o histórico de cobranças e reembolsos, com paginação e filtros opcionais de data, idioma, status e projeto.

Autenticação e permissões

string
obrigatório
Envie uma chave de API VoiceCheap neste cabeçalho. Authorization: Bearer com a mesma chave de API também é aceito. Tokens de acesso OAuth são aceitos apenas pelo MCP, não por este endpoint REST.
Permissões necessárias: usage:read. É necessária uma assinatura paga ativa. As permissões não alteram funções na equipe, propriedade dos recursos, créditos de mídia ou limites do plano.

Parâmetros

string
Valor de texto.Valores aceitos: “translation”, “project”. Valor padrão: “translation”.
string
Valor de texto.Comprimento mínimo: 1. Comprimento máximo: 200. Padrão: ^[^/]+$.
string
Valor de texto.Comprimento mínimo: 1. Comprimento máximo: 200.
string
Valor de texto.Comprimento mínimo: 2. Comprimento máximo: 64.
string
Valor de texto.Valores aceitos: “all”, “none”, “standard”, “pro”, “pro_2”.
array
Lista de valores. Consulte o esquema de entrada completo para ver a estrutura dos itens.Máximo de itens: 4.
string
Valor de texto.Valores aceitos: “all”, “charged”, “refunded”, “refund_pending”.
string
Valor de texto.Formato: “date”. Padrão: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$.
string
Valor de texto.Formato: “date”. Padrão: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$.
integer
Valor inteiro.Mínimo: 1. Máximo: 100000. Valor padrão: 1.
integer
Valor inteiro.Mínimo: 1. Máximo: 100. Valor padrão: 25.
O JSON Schema abaixo preserva os nomes exatos dos campos, tipos aninhados, valores padrão, limites e valores aceitos expostos pela descoberta. Regras adicionais entre campos são listadas nas notas da operação.

Exemplos de requisição

Substitua os identificadores de recursos e as chaves de mídia dos exemplos pelos valores retornados para sua conta. Mantenha o identificador da requisição ao tentar novamente a mesma alteração.

Resposta

Uma primeira execução bem-sucedida retorna HTTP 200 com o resultado da operação em data. Uma repetição pode retornar o estado salvo da requisição. O exemplo mostra uma resposta aceita, não todos os campos opcionais. Retorna linhas paginadas de uso de tradução ou projeto, filtros normalizados e totais de minutos de todas as linhas correspondentes.

Campos do resultado

Notas da operação

  • view tem translation como padrão, page tem 1 e pageSize tem 25; pageSize não pode exceder 100.
  • Os filtros de data usam YYYY-MM-DD e comparam a data de início da tradução em Europe/Paris. fromDate não pode ser posterior a toDate.
  • project pesquisa nomes e IDs de projetos sem diferenciar maiúsculas de minúsculas. translatedVersionId corresponde a IDs de versão por substring na visualização translation e é ignorado na visualização project.
  • Os totais abrangem todas as linhas de tradução correspondentes antes da paginação. A visualização project agrega essas linhas por projeto.
  • As linhas públicas omitem os endereços de e-mail dos usuários que iniciaram a ação e as mensagens brutas de erro de processamento.

Uso

Cada chamada bem-sucedida consome uma chamada mensal da API/MCP. Os créditos de mídia e as cotas de geração da própria operação também se aplicam.

Erros