Migration Guide: Endpoint listado de vacancies (basic)

El endpoint de listado de vacancies (basic) será dado de baja el 18 de agosto de 2026. A partir de esa fecha el endpoint dejará de estar disponible. A continuación se describen las dos alternativas recomendadas para migrar tu integración antes de esa fecha.

En lugar de solicitar el listado completo de vacantes periódicamente, puedes suscribirte al webhook de creación de vacantes. Cada vez que se publique una nueva vacante recibirás una notificación en tiempo real con los datos relevantes, incluyendo el identificador único.

Ventajas:

• Sin dependencia de polling ni llamadas periódicas a la API.
• Sin riesgo de alcanzar el rate limit.
• Datos siempre actualizados en el momento del evento.

Pasos:

1. Registra un endpoint HTTPS en tu sistema que pueda recibir eventos POST.
2. Solicita la suscripción al evento de creación de vacantes por email siguiendo el proceso descrito en la documentación de Webhooks.
3. Al recibir cada evento, almacena el identificador de la vacante (id) en tu base de datos.
4. Usa ese identificador para consultar el detalle individual de la vacante cuando lo necesites.

Para más detalles sobre el formato del evento y cómo validar la firma, consulta la documentación de Webhooks.

Si necesitas acceder al histórico de vacantes o no puedes adoptar webhooks en este momento, puedes utilizar el endpoint de vacantes paginadas.

Importante: Este endpoint está sujeto a los límites de tasa (rate limits) de la API. Si realizas peticiones muy frecuentes puedes alcanzar el límite y recibir respuestas 429 Too Many Requests. Debes implementar un mecanismo de backoff y controlar la cadencia de tus solicitudes.

Pasos:

1. Realiza una petición GET al endpoint de vacantes paginadas incluyendo los parámetros limit y offset.
2. La respuesta incluye un objeto meta con los campos total, limit y offset. Usa total y limit para calcular cuántas páginas quedan.
3. Incrementa offset en limit en cada iteración para avanzar a la siguiente página hasta haber recorrido todos los registros (offset >= total).
4. Respeta los headers de rate limit (x-ratelimit-remaining-api_key_limit, x-ratelimit-reset-api_key_limit) y aplica espera cuando sea necesario.