Visión general

Actualizado 8 de septiembre de 2026

La API de Orbit permite que una cuenta lea sus propias vacantes y las publique donde quiera: una página de empleo en tu propio dominio, una intranet, el sitio de un socio. Wipperoz es la herramienta de producción; el origen eres tú. Tu dominio se queda con la autoridad de búsqueda, tu marca se queda con la persona candidata, y nosotros no nos interponemos entre tú y tu contratación.

Qué hace

• Lee tus vacantes. GET /v1/jobs devuelve los puestos que tu cuenta ha publicado, marcando los cerrados y los caducados, para que una página tuya pueda mostrar su propio estado de cierre en lugar de romper enlaces que ya publicó.
• Entrega las personas candidatas a la página de postulación alojada. Cada vacante lleva un applyLink. Envía ahí a quien quiera postularse. La página de postulación registra que vino de tu sitio, así las candidaturas de tu página de empleo y las de Wipperoz quedan separadas en tus analíticas.
• Recibe tus vacantes. POST /v1/jobs crea un puesto desde tu propio sistema —un ATS, una herramienta interna— como borrador, y POST /v1/jobs/{jobId}/publish lo pone en marcha. Editar y cerrar también están, así que un puesto que cambia en origen puede cambiar aquí.
• Sigue siendo tuya. Cada respuesta está limitada a la cuenta cuya clave hizo la petición. No hay lectura ni escritura entre cuentas, ni un endpoint de “todas las vacantes”.

Qué no hace

• Recibir candidaturas por la API. El consentimiento que la persona candidata da en la página de postulación alojada es lo que permite a Wipperoz crear su CV Virtual y enviarle una invitación para reclamarlo. Un formulario tuyo enviándonos datos nos haría actuar sobre un consentimiento que nunca vimos. Enlaza a applyLink; ese es todo el diseño.
• Guardar tus credenciales de portales de empleo ni publicar en ellos por ti. La distribución a portales es un feed al que apuntas un portal, no unas credenciales que nos entregas.
• Publicar sin que se lo pidas. Crear un puesto y publicarlo son dos llamadas, porque publicar gasta tus créditos. Nada se pone en marcha, ni cuesta nada, en una llamada que no hiciste.

Para quién es

• Una persona de selección o de ingeniería que conecta una página de empleo con los puestos que una cuenta publica en Orbit.
• Una agencia que evalúa si Orbit encaja en un flujo de trabajo existente con ATS o MCP.

Qué necesitas

1. Una cuenta de Orbit con al menos un puesto publicado.
2. Una clave de API creada en Orbit → Configuración → Claves de API, con el permiso que corresponda al trabajo: lectura de vacantes para una página de empleo, lectura y gestión de vacantes para publicar puestos además. La página siguiente lo explica paso a paso.

URLs base y versionado

Toda ruta empieza por /v1. Una API pública que consumen los sitios de otras personas no puede cambiar sobre la marcha, así que un cambio incompatible llegará como /v2 con /v1 todavía respondiendo.