# Referencia de la Local API

El cliente de escritorio de MoreLogin V2.73.0 o posterior sirve la Local API de RPA de navegador en `http://127.0.0.1:<port>/api/rpa/browser/v1`. Usa el puerto de la Local API que se muestra en la configuración del cliente; el predeterminado es `40000`.

La autenticación funciona igual que en el resto de la Local API; consulta [Autenticación](/es/api-reference/getting-started/authentication). Envía los cuerpos JSON con `Content-Type: application/json`. Una respuesta correcta es `{data,meta}` y una respuesta de error es `{error,meta}`. Los errores de autenticación usan el formato 401 estándar de la Local API. Gestiona los errores según el estado HTTP, `error.code`, `details` y las rutas de las incidencias, no según el texto del mensaje. [Convenciones de la API](/es/browser-rpa/api/common) describe todas las reglas.

## Directorio de endpoints

### Capacidades y nodos

| Operación | Método y ruta relativa |
|  --- | --- |
| [Obtener capacidades](/es/browser-rpa/api/get-capabilities) | `GET /capabilities` |
| [Listar tipos de nodo](/es/browser-rpa/api/list-node-types) | `GET /node-types` |
| [Obtener un contrato de nodo](/es/browser-rpa/api/get-node-type) | `GET /node-types/{nodeType}` |


### Validación del flujo de trabajo

| Operación | Método y ruta relativa |
|  --- | --- |
| [Validar un flujo de trabajo](/es/browser-rpa/api/validate-workflow) | `POST /validations` |


### Plantillas y edición de nodos

| Operación | Método y ruta relativa |
|  --- | --- |
| [Listar plantillas](/es/browser-rpa/api/list-templates) | `GET /templates` |
| [Crear una plantilla](/es/browser-rpa/api/create-template) | `POST /templates` |
| [Obtener una plantilla](/es/browser-rpa/api/get-template) | `GET /templates/{templateId}` |
| [Reemplazar una plantilla](/es/browser-rpa/api/replace-template) | `PUT /templates/{templateId}` |
| [Eliminar una plantilla](/es/browser-rpa/api/delete-template) | `DELETE /templates/{templateId}` |
| [Copiar una plantilla](/es/browser-rpa/api/copy-template) | `POST /templates/{templateId}/copies` |
| [Listar nodos de plantilla](/es/browser-rpa/api/list-template-nodes) | `GET /templates/{templateId}/nodes` |
| [Editar nodos de plantilla](/es/browser-rpa/api/edit-template-nodes) | `POST /templates/{templateId}/node-edits` |


### Ejecuciones y resultados

| Operación | Método y ruta relativa |
|  --- | --- |
| [Iniciar una ejecución](/es/browser-rpa/api/start-run) | `POST /runs` |
| [Listar ejecuciones](/es/browser-rpa/api/list-runs) | `GET /runs` |
| [Obtener detalles de la ejecución](/es/browser-rpa/api/get-run) | `GET /runs/{runId}` |
| [Cancelar una ejecución](/es/browser-rpa/api/cancel-run) | `POST /runs/{runId}/cancel` |
| [Listar ejecuciones de nodos](/es/browser-rpa/api/list-run-nodes) | `GET /runs/{runId}/nodes` |
| [Listar artefactos de la ejecución](/es/browser-rpa/api/list-run-artifacts) | `GET /runs/{runId}/artifacts` |


### Recuperación de solicitudes

| Operación | Método y ruta relativa |
|  --- | --- |
| [Obtener un recibo de solicitud](/es/browser-rpa/api/get-request-receipt) | `GET /requests/{key}` |


### Referencia compartida

- [Convenciones de la API](/es/browser-rpa/api/common)
- [Modelos de datos](/es/browser-rpa/api/data-types)
- [Flujo de trabajo, variables y nodos de estructura](/es/browser-rpa/api/workflow)
- [Códigos de error](/es/browser-rpa/api/error-codes)
- [Detalles de error y matriz de recuperación](/es/browser-rpa/api/recovery)
- [Observación de ejecuciones y recuperación de solicitudes](/es/browser-rpa/api/observation)


## Encabezados obligatorios para solicitudes de escritura

| Operación | `Idempotency-Key` | `X-RPA-Catalog-Revision` | `If-Match` |
|  --- | --- | --- | --- |
| [Crear una plantilla](/es/browser-rpa/api/create-template) | Recomendado | Obligatorio | — |
| [Reemplazar una plantilla](/es/browser-rpa/api/replace-template) | Recomendado | Obligatorio | Obligatorio |
| [Eliminar una plantilla](/es/browser-rpa/api/delete-template) | Recomendado | No obligatorio | Obligatorio |
| [Copiar una plantilla](/es/browser-rpa/api/copy-template) | Recomendado | Obligatorio | Obligatorio: el ETag de la plantilla de origen |
| [Editar nodos de plantilla](/es/browser-rpa/api/edit-template-nodes) | Recomendado | Obligatorio | Obligatorio |
| [Iniciar una ejecución](/es/browser-rpa/api/start-run) | Recomendado | Obligatorio | — |
| [Cancelar una ejecución](/es/browser-rpa/api/cancel-run) | Recomendado | No obligatorio | — |


`Idempotency-Key` es opcional, pero sin él un reintento tras un tiempo de espera agotado puede repetir la escritura. Genera un UUID nuevo para cada nueva intención de escritura y consérvalo junto con el método, la ruta, el cuerpo y el `If-Match` hasta conocer el resultado. `If-Match` recibe el `ETag` exacto que devuelve [Obtener una plantilla](/es/browser-rpa/api/get-template). `X-RPA-Catalog-Revision` recibe `data.catalogRevision` de [Obtener capacidades](/es/browser-rpa/api/get-capabilities). [Validar un flujo de trabajo](/es/browser-rpa/api/validate-workflow) es de solo lectura, no necesita ninguno de estos encabezados y no deja ningún recibo de solicitud.

## Contrato local legible por máquina

Lee `/openapi.json` en la URL base local para obtener el contrato HTTP. La URL del esquema del flujo de trabajo está en `data.docs.schema` de `GET /capabilities`.

## Editar una plantilla existente

Lee la plantilla más reciente y los contratos de los nodos que vas a editar. Para cambios puntuales, aplica las ediciones de nodos propuestas al árbol completo y valida con `purpose:"save"`, `source.kind:"inline"` y `source.base:{templateId,version}`. Envía las operaciones con `node-edits` cuando el candidato supere la validación. Cada lote guarda una sola versión nueva o no cambia nada. Envía nodos y bloques completos cuando los reemplaces, y repara las referencias cuando elimines nodos. Usa PUT para reemplazar la plantilla completa. Registra las dependencias de plantillas secundarias con su `{processId,revisionId}` actual y vuelve a leer las dependencias después de un conflicto de versión.

## Recuperación

| Situación | Siguiente paso |
|  --- | --- |
| Tiempo de espera agotado en una escritura, pérdida de conexión o resultado incierto | Consulta `GET /requests/{originalKey}`. Si es `completed`, usa el resultado original; si lo que se completó es el registro de una ejecución, aún tienes que comprobar el estado de la ejecución. Si es `accepted` o `committed`, sigue consultando durante un tiempo limitado. Ante `unknown`, un 404 normal o un recibo caducado, detén las escrituras automáticas y revisa el recurso. |
| `RPA_REQUEST_NOT_COMMITTED` con `safeToRetrySameKey=true` | Reintenta la misma intención con la clave, el método, la ruta y el cuerpo originales, y con el `If-Match` original, si lo hay. |
| Conflicto de versión 412 | Revisa primero el recibo. Después de verificar que la escritura no se confirmó, vuelve a leer la plantilla, combina los cambios, valida y envía la solicitud con una clave nueva y el ETag actual. |
| El catálogo cambió | Revisa el recibo y verifica que la escritura no se haya confirmado; después, actualiza las capacidades y los contratos. Si el cuerpo y el `If-Match` no cambian, actualiza el encabezado del catálogo y conserva la clave original. |
| `valid=false` o un error de entrada determinista | Corrige el problema en la ruta indicada y vuelve a validar. Si la escritura quedó registrada como fallida, verifica que no se haya confirmado nada antes de usar una clave nueva. Ante un 429 o un 503, respeta `Retry-After` y las reglas del recibo. |


Para ejecutar una plantilla guardada, consulta [Ejecutar una plantilla con la API](/es/browser-rpa/run-api-example).