- Portal bilingüe (Bootstrap), biblioteca FRM, consulta y perfiles con QR. - Integración REST penasquito.wotbi.com (Token, búsqueda por passport y polling). - Webhook de sincronización, esquema MariaDB y semillas FRM/NOM. - Documentación en docs/ y extracto DatosPdf.txt; ejemplo de config sin secretos locales. Co-authored-by: Cursor <cursoragent@cursor.com>
65 lines
2.5 KiB
Markdown
65 lines
2.5 KiB
Markdown
# 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 <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/<ticket_id>/`
|
|
|
|
- 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`.
|