Skip to main content
POST
Lista los proyectos accesibles con paginación, búsqueda por nombre y filtros de idioma y estado. Un invitado del equipo solo ve los proyectos de API que ha creado.

​
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: projects: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.Longitud mínima: 1. Longitud máxima: 200.
​
integer
Valor entero.Mínimo: 0. Máximo: 100000. Valor predeterminado: 0.
​
integer
Valor entero.Mínimo: 1. Máximo: 50. Valor predeterminado: 20.
​
string
Valor de texto.Valores permitidos: “afrikaans”, “albanian”, “amharic”, “arabic”, “armenian”, “assamese”, “azerbaijani”, “basque”, “belarusian”, “bengali”, “bosnian”, “bulgarian”, “catalan”, “croatian”, “czech”, “danish”, “dutch”, “english”, “british english”, “estonian”, “finnish”, “french”, “french canadian”, “galician”, “german”, “greek”, “gujarati”, “hebrew”, “hindi”, “hungarian”, “icelandic”, “indonesian”, “irish”, “italian”, “japanese”, “kannada”, “kazakh”, “khmer”, “korean”, “lao”, “latvian”, “lithuanian”, “macedonian”, “malay”, “malayalam”, “mandarin”, “marathi”, “mongolian”, “nepali”, “norwegian”, “persian”, “polish”, “portuguese”, “brazilian portuguese”, “pt_brazil”, “punjabi”, “romanian”, “russian”, “serbian”, “slovak”, “slovenian”, “spanish”, “swahili”, “swedish”, “tagalog”, “tamil”, “telugu”, “thai”, “turkish”, “ukrainian”, “urdu”, “vietnamese”, “welsh”, “yoruba”, “zulu”.
​
string
Valor de texto.Valores permitidos: “af”, “sq”, “am”, “ar”, “hy”, “as”, “ast”, “az”, “ba”, “eu”, “be”, “bn”, “bs”, “br”, “bg”, “my”, “ca”, “ceb”, “zh”, “hr”, “cs”, “da”, “nl”, “en”, “eo”, “at”, “et”, “fil”, “fo”, “fi”, “fr”, “fr-CA”, “fy”, “ff”, “gd”, “gl”, “lg”, “ka”, “de”, “el”, “gu”, “ht”, “ha”, “haw”, “he”, “hi”, “hu”, “is”, “ig”, “ilo”, “id”, “ia”, “ga”, “it”, “ja”, “jv”, “kea”, “kn”, “kk”, “km”, “kur”, “kir”, “ko”, “lo”, “la”, “luo”, “lv”, “lb”, “ln”, “lt”, “mk”, “mg”, “ms”, “ml”, “mt”, “mi”, “mr”, “mo”, “mn”, “ne”, “no”, “nn”, “nso”, “nya”, “oc”, “or”, “pa”, “ps”, “fa”, “pl”, “pt”, “ro”, “ru”, “sa”, “sr”, “sn”, “sd”, “si”, “sk”, “sl”, “so”, “es”, “su”, “sw”, “ss”, “sv”, “tl”, “tg”, “ta”, “tt”, “te”, “th”, “bo”, “tn”, “tr”, “tk”, “ug”, “uk”, “umb”, “ur”, “uz”, “vi”, “cy”, “wo”, “xh”, “yi”, “yo”, “zu”, “cmn”, “yue”, “en-GB”, “en-US”, “en-AU”, “auto-detect”.
​
string
Valor de texto.Valores permitidos: “awaitingProofreading”, “translated”, “failed”.
​
string
Valor de texto.Valores permitidos: “newestFirst”, “oldestFirst”. Valor predeterminado: “newestFirst”.
​
string
Valor de texto.Longitud mínima: 1. Longitud máxima: 200. Patrón: ^[^/\\]+$.
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 una página de resúmenes de proyectos accesibles y metadatos de paginación por desplazamiento.

​
Campos del resultado

​
Notas de la operación

  • El valor predeterminado de offset es 0, el de limit es 20 (máximo 50) y el de sort es newestFirst. query busca por nombre de proyecto; folderId, el idioma de origen, el idioma de destino y status filtran la lista.
  • Los campos de proyecto devueltos son projectId, projectName, originalLanguage, targetLanguages, duration, createdAt, progressStep y folderId. Los campos opcionales no almacenados pueden omitirse; targetLanguages tiene el valor predeterminado [], duration el valor 0 y folderId el valor null.
  • nextOffset se establece cuando la página subyacente recuperada contiene limit elementos; no es un recuento total ni demuestra que exista otro resultado accesible.
  • Los invitados del equipo solo ven los proyectos creados mediante la API por ese mismo miembro en el mismo equipo. El filtrado puede producir un array projects más corto aunque aparezca nextOffset.
  • originalLanguage usa códigos del idioma de origen como fr o en (o auto-detect donde se acepte); targetLanguage usa nombres de idiomas de destino compatibles como english.

​
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