---
title: Visión general de la API
description: Los endpoints de Human Plugin, cómo se relacionan, las reglas de respuesta comunes y lo que la API no ofrece.
canonical: https://developer.unico.io/es/human-plugin/api-reference/overview
locale: es
generated_by: markdown-export
---

# Visión general de la API

Tres endpoints de procesos y dos probes de salud.

Human Plugin se sirve por HTTP plano en el puerto que configures (por defecto `8080`). La URL base es el lugar donde expongas el contenedor dentro de tu red, por ejemplo `http://human-plugin.internal:8080`.

| Método | Ruta | Propósito |
| --- | --- | --- |
| `POST` | `/v1/processes` | [Crear un proceso](/es/human-plugin/api-reference/create-process), con uno de los [flujos](/es/human-plugin/api-reference/create-process#flows) |
| `GET` | `/v1/processes/{id}` | [Obtener un proceso](/es/human-plugin/api-reference/get-process) |
| `GET` | `/v1/processes/{id}/selfie` | [Obtener la selfie](/es/human-plugin/api-reference/get-selfie) |
| `GET` | `/health/live` | Liveness. Consulta [Salud y monitoreo](/es/human-plugin/self-hosting/health-and-monitoring) |
| `GET` | `/health/ready` | Readiness (ping a la base de datos) |

No hay ningún endpoint para listar, eliminar o buscar procesos, ni un receptor de webhooks.

## Reglas que se aplican a todas las llamadas

- **Sin encabezado de autenticación.** Human Plugin no valida a quien llama. Restringe el acceso de red en su lugar: consulta [Redes y seguridad](/es/human-plugin/self-hosting/networking-and-security).
- **Solo JSON**, con nombres de campo en camelCase.
- **Las respuestas llevan `Cache-Control: no-store`.**
- **Los errores** usan un único envelope, `{"message": "INVALID_REQUEST", "details": []}`. Consulta [Errores y reintentos](/es/human-plugin/api-reference/errors-and-retries).
- **`id` es el id de proceso de Human Plugin.** Guárdalo de la creación: es como lees el proceso después.

## Secuencia típica

```mermaid
sequenceDiagram
  participant B as Your back-end
  participant H as Human Plugin
  B->>H: POST /v1/processes
  H-->>B: 201 + id, state, data
  B->>H: GET /v1/processes/{id}
  H-->>B: 200 + id, state, data (humanToken, ndocs)
```

Siguiente: [Crear un proceso](/es/human-plugin/api-reference/create-process).