# API DC3 Peñasquito (Wotbi) — CertiMine Fuente detallada del flujo de scraping en Mobilise-Me: ver [DatosPdf.txt](../DatosPdf.txt) en el repositorio (texto extraído manualmente del PDF). ## Autenticación Todas las peticiones al API REST llevan un **token estático** entregado por canal privado: ```http Authorization: Token ``` Sin cabecera válida → **HTTP 401**. En CertiMine configure `CERTIMINE_DC3_TOKEN` (recomendado) o `penasquito_dc3.static_token` en `config/config.php`. **No subir el token real al control de versiones.** ## Base URL `https://penasquito.wotbi.com` (según DatosPdf.txt). ## Endpoint 1 — Crear solicitud de búsqueda `POST /api/v1/dc3/competencies/passports/search/` - `Content-Type: application/json` - Body: `{ "passport": "E000055821" }` - Respuesta si hay caché (~1 h): `status: "completed"` + `result` (name, company, competencies[]). - Respuesta si encola: `status: "pending"` + `ticket_id` (+ opcional `posicion`). ## Endpoint 2 — Resultado del ticket (polling) `GET /api/v1/dc3/competencies/passports/result//` - Mientras trabaja el worker: `status` puede ser `pending` o `processing`. - Al terminar: `status: "completed"` + `result`. Flujo recomendado: llamar endpoint 1; si `pending`, consultar endpoint 2 cada pocos segundos hasta `completed` (implementado en `PenasquitoDc3Api::fetchResultForPassport`). ## Endpoint 3 — Estado de cola `GET /api/v1/dc3/competencies/passports/status/` - `queue_length`, `processing` — monitoreo / health. ## Estructura de `result` | Campo | Uso | |--------|-----| | `passport` | ID consultado (coincide con búsqueda). | | `name` | Nombre. | | `company` | Empresa; CertiMine infiere contratista vs empleado con reglas heurísticas. | | `competencies[]` | `activity`, `request_date`, `expiration_date` (null si no aplica), `status`. | | `error` | Si no es null, mensaje de fallo. | ## Portal Mobilise-Me (scraping interno) El documento describe además el login web (`testing.newmontpenasquito.mobilise-me.com`), cookies, CSRF, pas **`/Selection`** con `action=Administration Database`, etc. Eso lo ejecuta el **servidor** que alimenta el API anterior, no el navegador del usuario de CertiMine. ## Webhook CertiMine CertiMine sigue aceptando `POST public/api/webhook.php` para sincronizar certificados desde otros sistemas (ver implementación). Es independiente del API Wotbi anterior. ## Configuración PHP Rutas y tiempos de polling: `config/config.example.php` → sección `penasquito_dc3`.