Saltar al contenido principal

Inicio rápido

Lo único que necesitas para empezar a usar Palenca es una cuenta de usuario y una API Key. Puedes obtenerlas aquí.

info

Tenemos 2 entornos: Sandbox y Producción. Para una referencia completa sobre todos las rutas de nuestra API da click aquí.

https://sandbox.palenca.com/v1
https://api.palenca.com/v1

1. Obtén tu API Key

Para poder realizar cualquier petición a la API, necesitarás identificarte usando tu API Key privada. Esta debe enviarse en los encabezados como x-api-key.

--header 'x-api-key: private_api_key' \
--header 'Content-Type: application/json'

2. Crea tu primera conexión

En este paso crearemos un user (que representa un trabajador) y un account(que representa una conexión al IMSS) haciendo una solicitud POST al endpoint /users/accounts. Esta solicitud debe incluir en el payload el CURP del trabajador (parámetro identifier) y la plataforma donde estableceremos la conexión (en este caso IMSS). No olvides incluir la clave privada en los encabezados.

curl --location --request POST 'https://sandbox.palenca.com/v1/users/accounts' \
--header 'x-api-key: YOUR_PRIVATE_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"identifier": "WORKER_CURP",
"country": "mx",
"platform": "imss"
"widget_id": "YOUR_WIDGET_ID" // if empty, the default widget will be used
}'

Si todo funcionó correctamente, deberás ver una respuesta como esta y el proceso para obtener los datos de empleo se ha iniciado:

{
"success": True,
"error": None,
"data": {
"user_id": "054d0a9d-38ec-40cb-a31c-09b483242e4a",
"country": "mx",
"platform": "imss",
"account_id": "472f02e8-6b24-43a7-b529-3f71d6ecc81c"
}
}

3. Obtén los datos de empleo

El proceso de obtener los datos de empleo del trabajador depende de cada plataforma. Una vez pasado este tiempo estamos listos para recuperar el historial laboral del trabajador. Para hacerlo, necesitamos realizar una solicitud GET a /accounts/{account_id}/employment. Podrás ver una lista de las empresas en las que este usuario ha trabajado, sus entidades federales y salarios.

curl --location --request GET 'https://sandbox.palenca.com/v1/accounts/:account_id/employment' \
--header 'x-api-key: YOUR_PRIVATE_API_KEY' \
--header 'Content-Type: application/json'

4. Integra un Webhook

Para no depender del tiempo de respuesta de Palenca y tener que esperar que se encuentren listos los datos de empleo, te recomendamos implementar un Webhook que te permitirá recibir una notificación una vez se encuentren disponibles los datos para consulta.

Importante

Consulta la guía para implementar webhooks aquí. Si necesitas ayuda en tu implementación, da click aquí