Tutoriales de Integración API
Guías paso a paso para conectar tu sistema con la inteligencia de riesgo y cumplimiento de CRiskCo.
Guías Paso a Paso
1. Obtener tu API Key
Regístrate en el portal de CRiskCo para obtener tus credenciales de API. Recibirás un client_id y client_secret para autenticarte.
POST /oauth/token
Content-Type: application/json
{
"client_id": "your_client_id",
"client_secret": "your_client_secret",
"grant_type": "client_credentials"
}
2. Autenticación
Usa OAuth 2.0 con credenciales de cliente para obtener un token de acceso. Incluye el token en el header Authorization de cada solicitud.
// Response
{
"access_token": "eyJhbGciOiJSUzI1NiIs...",
"token_type": "Bearer",
"expires_in": 3600
}
// Use in requests
Authorization: Bearer eyJhbGciOiJSUzI1NiIs...
3. Consultar un Reporte de Empresa
Con tu token, consulta reportes de riesgo crediticio, cumplimiento y exposición de cualquier empresa registrada en México usando su RFC.
GET /api/v2/company/report?rfc=XAXX010101000
Authorization: Bearer {access_token}
// Response
{
"company": {
"rfc": "XAXX010101000",
"name": "Empresa Demo S.A. de C.V.",
"fin_score": 78,
"compliance_status": "active",
"blacklist_flags": []
}
}
4. Monitoreo Continuo
Configura webhooks para recibir alertas cuando cambien los indicadores de riesgo o cumplimiento de las empresas que monitoreas.
POST /api/v2/webhooks
Authorization: Bearer {access_token}
Content-Type: application/json
{
"url": "https://your-app.com/webhook",
"events": [
"compliance.status_changed",
"risk.score_changed",
"blacklist.flag_added"
]
}
5. Integración con tu Sistema
Usa nuestros SDKs o llama directamente a la API REST. Soportamos integración con cualquier lenguaje de programación y plataformas como Zapier.
// Node.js example
const response = await fetch(
'https://api.criskco.com/api/v2/company/report?rfc=XAXX010101000',
{
headers: {
'Authorization': `Bearer ${accessToken}`,
'Content-Type': 'application/json'
}
}
);
const report = await response.json();
console.log(report.company.fin_score);
¿Listo para integrar?
Regístrate para obtener tu API Key y comienza a consumir datos de riesgo y cumplimiento en minutos.