# Migration Guide: Endpoint listado de vacancies (basic)

|  |  |
|  --- | --- |
| **Anunciado** | 2026-06-18 |
| **Expira** | 2026-08-18 |


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.

## Alternativa 1: Webhook de creación de vacantes (recomendada)

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](/docs/webhooks#requesting-a-webhook-subscription).
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](/docs/webhooks).

## Alternativa 2: Endpoint de vacantes paginadas

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)](/docs/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.