certimine/docs/mobiliseme-api.md
remaster a72656f9d4 CertiMine: aplicación PHP, API DC3 Peñasquito y documentación
- 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>
2026-05-13 17:56:36 -06:00

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 (+ 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.