Auto-traducir formulario

POST

/api/forms/{id}/translate

Auto-traduce con IA (Microsoft Translator) los campos vacíos de un formulario (título, label/sublabel/placeholder de cada campo, texto de las opciones y mensaje de agradecimiento) hacia un idioma secundario activo de la cuenta. Solo rellena lo que esté vacío — nunca pisa una traducción ya escrita a mano o por PUT /api/forms/{id}. El value de las opciones nunca se traduce (es la clave que se guarda en las respuestas). Mismo motor y misma cuota mensual que la traducción de productos/páginas.

Solicitud

Parámetros de ruta

Parámetros de Header

Parámetros del Body application/jsonRequerido

Ejemplos

Respuestas

🟢200

application/json

OK. Si no había campos vacíos por traducir, incluye message y characters_used=0.

Bodyapplication/json

🟠400

🟠404

🟠429

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

curl --location 'https://app.mgpanel.co/api/forms//translate' \
--header 'X-Account-Nick: {{ACCOUNT_NICK}}' \
--header 'Authorization: Bearer {{API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
    "code": "us"
}'

Ejemplo de Respuesta

200 - Éxito

{
    "success": true,
    "translation": {
        "code": "us",
        "title": "MCP Test Form",
        "fields": [
            {
                "fieldId": "60a1000000000000000000aa",
                "label": "Full Name",
                "sublabel": "",
                "placeholder": "Write your name",
                "options": []
            }
        ],
        "thanks": {
            "message": ""
        },
        "is_auto_translated": true
    },
    "status": {
        "code": "us",
        "name": "English",
        "translated": 6,
        "total": 11,
        "isAutoTranslated": true,
        "stale": false,
        "exists": true
    },
    "characters_used": 99
}

Modificado en 2026-09-02 22:39:03

Detalle de una respuesta

Actualizar estado de una respuesta