> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/api-rest/midapi-v2.md).

# MIDAPI v2

**MIDAPI v2** es la API REST síncrona del ecosistema de APIs de Facephi. Expone los servicios de verificación de identidad y antifraude mediante endpoints REST autenticados con OAuth2, pensados para integradores y desarrolladores backend.

### Conceptos: plataforma del cliente y consumer

Antes de integrar cualquier servicio de MIDAPI v2 conviene conocer los dos conceptos sobre los que se organiza el acceso:

* **Plataforma del cliente**: representa la relación única entre el cliente y Facephi. Se identifica con la cabecera `platform-id` y tiene asociada una API key. Existe una única plataforma por cliente.
* **Consumer**: representa un canal o vertical de negocio del cliente (por ejemplo, el canal web y la app móvil, o verticales como seguros e inversiones). Se identifica con la cabecera `consumer-id`. Cada consumer tiene habilitados únicamente los servicios contratados para ese canal, con límites de uso y trazabilidad independientes.

Como parte del alta del servicio, se proveerá al cliente la **URL base** de la API, las **credenciales de la plataforma** y **al menos un consumer** (uno por cada canal o vertical que necesite integrar). Todas las rutas de esta guía son relativas a esa URL base (por ejemplo, `POST <URL base>/consumer/token`). Este modelo permite gestionar permisos, límites y trazabilidad de forma independiente por canal, manteniendo una única plataforma por cliente.

Con estos dos conceptos se obtiene el token de acceso: la plataforma emite tokens para sus consumers, y cada llamada operativa se hace en nombre de un consumer. El detalle está en [Autenticación](/api-rest/midapi-v2/autenticacion.md).

### Servicios disponibles

| Servicio                                                | Descripción                                                                                                        |
| ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| [DAF (Document Anti-Fraud)](/api-rest/midapi-v2/daf.md) | Validación antifraude de documentos de identidad, con selfie opcional y diagnóstico final (`APPROVED`/`DECLINED`). |