{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/es/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Ejecutar una plantilla con la API"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"ejecutar-una-plantilla-con-la-api","__idx":0},"children":["Ejecutar una plantilla con la API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Continúa en la misma sesión de Bash y en el mismo directorio de trabajo del ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/es/browser-rpa/quickstart"},"children":["inicio rápido"]},". Primero comprueba que el cliente admita las operaciones que usa esta página:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"jq -e '.data.operations as $ops | [\"validateWorkflow\",\"startRun\",\"getRun\",\"listRunNodes\",\"listRunArtifacts\"] - $ops | length == 0' capabilities.json\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Elige un perfil de navegador Chromium. El ID del entorno es el ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["envId"]}," del perfil. Si solo conoces el nombre del perfil, búscalo con ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ml-cli env find --keyword <keyword>"]}," o con ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/env/page"]}," de la ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/es/api-reference/browser/local-api"},"children":["Local API de navegador"]},", y resuelve cualquier ambigüedad antes de ejecutar. Para confirmar el tipo de navegador, comprueba que ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/env/detail"]}," devuelva ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["browserTypeId: 1"]},". Pasa el ID como cadena. Las posiciones en la lista y los puertos de depuración no son ID de perfil."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"1-realizar-la-verificación-previa-de-la-versión-guardada","__idx":1},"children":["1. Realizar la verificación previa de la versión guardada"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Usa el mismo ID de plantilla, la misma versión, el mismo entorno y los mismos parámetros en la verificación previa y en la ejecución. Proporciona el valor de cada parámetro como ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{kind:\"json\",value:...}"]},". Los parámetros privados se envían como texto plano, y los parámetros de archivo usan rutas locales absolutas (un array si hay varios archivos). Este ejemplo no tiene parámetros privados. Continúa solo cuando el informe de validación muestre ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["valid: true"]}," y esté completo. Si el perfil está ocupado, espera hasta que la ejecución anterior libere su aislamiento."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":": \"${RPA_ENVIRONMENT_ID:?Set the actual Chromium profile ID first}\"\njq --arg env \"$RPA_ENVIRONMENT_ID\" '\n  .data | {templateId:.id,version,environmentId:$env,\n    parameters:{targetUrl:{kind:\"json\",value:\"https://example.com\"}}}\n' created.json > start-run.json &&\njq '{purpose:\"run\",source:{kind:\"template\",templateId,version},\n    environmentId,parameters}' start-run.json > validate-run.json &&\nrpa_curl \"$RPA_BASE_URL/validations\" -H 'Content-Type: application/json' --data-binary @validate-run.json -o validation-run.json &&\njq '.data | {valid,issues,truncated,runtimeChecks}' validation-run.json &&\njq -e '.data.valid == true and .data.truncated == false' validation-run.json\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"2-iniciar-la-ejecución","__idx":2},"children":["2. Iniciar la ejecución"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"([ -s run.key ] || uuidgen > run.key) &&\nrpa_curl \"$RPA_BASE_URL/runs\" \\\n  -H 'Content-Type: application/json' \\\n  -H \"X-RPA-Catalog-Revision: $RPA_CATALOG_REVISION\" \\\n  -H \"Idempotency-Key: $(cat run.key)\" \\\n  --data-binary @start-run.json -o started.json &&\nRPA_RUN_ID=\"$(jq -er '.data.id' started.json)\" &&\njq '.data | {id,status,template}' started.json\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["HTTP 202 significa que la ejecución quedó registrada, no que terminó. Conserva el ID de la ejecución, la clave original y la revisión congelada de la plantilla. Un tiempo de espera agotado en el transporte no cancela la ejecución: usa la ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/es/browser-rpa/local-api#recuperaci%C3%B3n"},"children":["recuperación de solicitudes"]}," antes de enviar otra escritura."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"3-esperar-un-estado-terminal","__idx":3},"children":["3. Esperar un estado terminal"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"for attempt in $(seq 1 100); do\n  rpa_curl \"$RPA_BASE_URL/runs/$RPA_RUN_ID\" -o run-detail.json || break\n  status=\"$(jq -r '.data.run.status' run-detail.json)\"\n  echo \"status: $status\"\n  case \"$status\" in\n    success|failed|cancelled|stopped|missed) break ;;\n    queued) sleep 5 ;;\n    *) sleep 3 ;;\n  esac\ndone\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["El bucle consulta una ejecución activa cada 3 segundos y una ejecución en cola cada 5 segundos, y se detiene después de 100 consultas. Los estados activos son ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["queued"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["preparing"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["running"]}," y ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cancel_requested"]},". Los estados terminales son ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["success"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["failed"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cancelled"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["stopped"]}," y ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["missed"]},". Mantén todas las solicitudes de observación en un máximo de 40 por minuto y respeta ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Retry-After"]}," ante un 429 o un 503."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"4-leer-el-resultado","__idx":4},"children":["4. Leer el resultado"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"jq '.data | {status:.run.status,hasNodeErrors:.run.hasNodeErrors,\n             isolation:.run.isolation,outputs:.result.outputs,error:.result.error}' run-detail.json &&\nrpa_curl \"$RPA_BASE_URL/runs/$RPA_RUN_ID/nodes?page=1&pageSize=20\" -o run-nodes.json &&\nrpa_curl \"$RPA_BASE_URL/runs/$RPA_RUN_ID/artifacts\" -o run-artifacts.json\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["El ejemplo devuelve ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["outputs.result: \"https://example.com/\""]},". Revisa ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.run.hasNodeErrors"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.run.isolation.state"]}," y tanto ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.result.outputs"]}," como ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.result.error"]},": una ejecución puede completarse correctamente aunque algunos nodos hayan fallado y se hayan omitido."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Los registros de ejecución de nodos están paginados. Mientras una ejecución está activa, lee desde la página 1 en cada pasada y combina los registros por ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["items[].id"]},". Cuando la ejecución alcance un estado terminal, lee todas las páginas sin filtro de estado. El endpoint de artefactos solo devuelve metadatos. Oculta los datos sensibles de la salida antes de compartirla."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["La cancelación es una solicitud: sigue comprobando el estado terminal real y el estado de aislamiento. No reinicies automáticamente cuando el resultado sea incierto o el entorno siga en cuarentena. Para más detalles, consulta ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/es/browser-rpa/api/get-run"},"children":["Obtener detalles de la ejecución"]},", ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/es/browser-rpa/api/list-run-nodes"},"children":["Listar ejecuciones de nodos"]}," y ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/es/browser-rpa/api/observation"},"children":["Observación de ejecuciones y recuperación de solicitudes"]},"."]}]},"headings":[{"value":"Ejecutar una plantilla con la API","id":"ejecutar-una-plantilla-con-la-api","depth":1},{"value":"1. Realizar la verificación previa de la versión guardada","id":"1-realizar-la-verificación-previa-de-la-versión-guardada","depth":2},{"value":"2. Iniciar la ejecución","id":"2-iniciar-la-ejecución","depth":2},{"value":"3. Esperar un estado terminal","id":"3-esperar-un-estado-terminal","depth":2},{"value":"4. Leer el resultado","id":"4-leer-el-resultado","depth":2}],"frontmatter":{"seo":{"title":"Ejecutar una plantilla con la API"}},"lastModified":"2026-11-20T14:40:39.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/es/browser-rpa/run-api-example","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}