- 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>
2.5 KiB
API DC3 Peñasquito (Wotbi) — CertiMine
Fuente detallada del flujo de scraping en Mobilise-Me: ver 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:
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(+ opcionalposicion).
Endpoint 2 — Resultado del ticket (polling)
GET /api/v1/dc3/competencies/passports/result/<ticket_id>/
- Mientras trabaja el worker:
statuspuede serpendingoprocessing. - 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.