API REST
para integrar tu empresa con MineriAR
Catálogos del sector, ofertas laborales, verificación de credenciales digitales, endpoint compatible con HR Open Standards. Para que tu ATS, ERP o sistema interno hable con MineriAR sin fricción.
⚠ Acceso solo para empresas. Los tokens de API se generan exclusivamente desde una cuenta de empresa (minera o proveedora). Las cuentas individuales (postulantes) no pueden acceder a la API ni emitir tokens — los datos del sector están protegidos detrás del registro empresarial.
🚀 Empezar en 2 pasos
- Registrá tu empresa en MineriAR (gratis). Necesitás cuenta empresarial activa — los tokens no se emiten a personas individuales.
- En
/empresa/api-tokens(visible solo desde el rol empresa) generás tu token Bearer.
$ curl -H "Authorization: Bearer TU_TOKEN" \
"https://mineriar.com/api/v1/jobs?province=mendoza"
{
"data": [...],
"meta": { "total": 12, "per_page": 20 }
}
Endpoints disponibles
GET /api/v1/jobs — Ofertas laborales
Lista todas las ofertas activas del sector. Filtros por provincia, skill, kind de empresa, etc. Útil para mostrar oportunidades del sector en tu intranet o app interna.
Detalle individual: GET /api/v1/jobs/{slug}
GET /api/v1/skills — Catálogo de habilidades
GET /api/v1/certifications — Certificaciones reconocidas
GET /api/v1/provinces — Provincias
POST /api/v1/passport/verify — Verificar credencial digital
Verifica una credencial firmada (Skill Passport AR-MINING-VC-1.0). Recibís el JWS, devolvemos si es válido, quién la emitió, qué certifica y cuándo expira.
Interoperable entre provincias: cualquier credencial emitida por una provincia argentina se verifica con este endpoint.
GET /api/v1/hropen/position-openings — HR Open Standards
GET /api/v1/datasets.jsonld — Catálogo DCAT
GET /api/v1/transparency/* — Datos públicos agregados
🔧 En el roadmap
Estos endpoints están en desarrollo. Si necesitás alguno priorizado para tu integración, escribinos y arrancamos por ese.
- POST
/api/v1/jobs— Publicar búsquedas desde tu ATS sin entrar al panel - GET
/api/v1/talent/search— Búsqueda de talento por skill / provincia / experiencia, anonimizada - POST
/api/v1/procurement-requests— Publicar solicitudes de compra (RFQ) desde tu ERP - GET
/api/v1/procurement-requests— Recibir oportunidades de venta filtrables por rubro - Webhooks:
job.application.created,procurement.quote.received,procurement.awarded
📚 Estándares
- • HR Open Standards (PositionOpening)
- • DCAT 3.0 para datasets abiertos
- • Skill Passport AR-MINING-VC-1.0 (W3C VC + Ed25519)
- • OAuth 2.0 Bearer tokens
- • JSON / JSON-LD para responses
🔒 Privacidad y rate limits
- • Datos personales nunca expuestos sin consentimiento
- • k-anonymity ≥ 5 en agregados públicos
- • 60 req/min default por token
- • Cumple Ley 25.326 (Habeas Data)
- • Tokens revocables desde el panel
¿Querés integrar tu sistema con MineriAR?
Si sos minera, proveedora, ATS, cámara o ministerio y necesitás un endpoint que todavía no esté listo, escribinos. Priorizamos según demanda real.
Recordatorio: los tokens de API solo se emiten a cuentas de empresa activas y verificadas.