Skip to main content
POST
Obtén el consumo de minutos de traducción y sincronización labial y el historial de cargos y reembolsos, con paginación y filtros opcionales de fecha, idioma, estado y proyecto.

​
Autenticación y permisos

​
string
requerido
Envía una clave de API de VoiceCheap en esta cabecera. También se admite Authorization: Bearer con la misma clave de API. Los tokens de acceso OAuth solo se aceptan en MCP, no en este endpoint REST.
Permisos necesarios: usage:read. Se requiere una suscripción de pago activa. Los permisos no cambian los roles del equipo, la propiedad de los recursos, los créditos multimedia ni los límites del plan.

​
Parámetros

​
string
Valor de texto.Valores permitidos: “translation”, “project”. Valor predeterminado: “translation”.
​
string
Valor de texto.Longitud mínima: 1. Longitud máxima: 200. Patrón: ^[^/]+$.
​
string
Valor de texto.Longitud mínima: 1. Longitud máxima: 200.
​
string
Valor de texto.Longitud mínima: 2. Longitud máxima: 64.
​
string
Valor de texto.Valores permitidos: “all”, “none”, “standard”, “pro”, “pro_2”.
​
array
Lista de valores. Consulta la estructura de sus elementos en el esquema completo de entrada.Número máximo de elementos: 4.
​
string
Valor de texto.Valores permitidos: “all”, “charged”, “refunded”, “refund_pending”.
​
string
Valor de texto.Formato: “date”. Patrón: ^(?:(?:\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”. Patrón: ^(?:(?:\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 entero.Mínimo: 1. Máximo: 100000. Valor predeterminado: 1.
​
integer
Valor entero.Mínimo: 1. Máximo: 100. Valor predeterminado: 25.
El JSON Schema siguiente conserva los nombres exactos de los campos, los tipos anidados, los valores predeterminados, los límites y los valores aceptados que expone el descubrimiento. Las reglas adicionales entre campos se indican en las notas de la operación.

​
Ejemplos de solicitud

Sustituye los identificadores de recursos y las claves multimedia de los ejemplos por valores devueltos para tu cuenta. Mantén el identificador de solicitud al reintentar la misma modificación.

​
Respuesta

Una primera ejecución correcta devuelve HTTP 200 con el resultado de la operación en data. Una repetición puede devolver el estado de la solicitud guardada en su lugar. El ejemplo muestra una respuesta admitida, no todos los campos opcionales. Devuelve filas paginadas de uso de traducciones o proyectos, filtros normalizados y totales de minutos de todas las filas coincidentes.

​
Campos del resultado

​
Notas de la operación

  • view tiene como valor predeterminado translation, page 1 y pageSize 25; pageSize no puede superar 100.
  • Los filtros de fecha usan YYYY-MM-DD y comparan la fecha de inicio de la traducción en Europe/Paris. fromDate no puede ser posterior a toDate.
  • project busca nombres e ID de proyectos sin distinguir mayúsculas de minúsculas. translatedVersionId busca coincidencias por subcadena en los ID de versión en la vista de traducciones y se ignora en la vista de proyectos.
  • Los totales incluyen todas las filas de traducción coincidentes antes de la paginación. La vista de proyectos agrupa esas filas por proyecto.
  • Las filas públicas omiten las direcciones de correo electrónico de los usuarios que iniciaron la acción y los mensajes de error de procesamiento sin procesar.

​
Uso

Cada invocación correcta consume una llamada mensual de API/MCP. También se aplican los créditos multimedia y las cuotas de generación propias de la operación.

​
Errores