Crear una clave de API para la API de Orbit

Esto es para administradores de la cuenta que conectan una página de empleo u otro sistema a Orbit. Creas la clave en Orbit y la pegas en ese sistema. La documentación para desarrolladores explica cómo usarla.

Abre Configuración

Selecciona Configuración en la barra lateral.

Abre Claves de API

En Cuenta, selecciona Claves de API.

Empieza una clave nueva

Selecciona Nueva clave.

Ponle una etiqueta a la clave

En Etiqueta, indica dónde se usará la clave, por ejemplo la dirección de tu página de empleo. Más adelante, esta etiqueta es lo que te permite saber si es seguro revocar una clave.

Elige a qué puede acceder

En A qué puede acceder, elige una opción:

• Solo lectura de empleos: tus puestos abiertos y sus detalles, sin nada que se pueda modificar.
• Leer y gestionar empleos: además crea, edita, publica y cierra puestos. Dásela solo a un sistema que gestiones tú.
• Screening: los endpoints de evaluación de candidatos. Solo para un servidor que controles tú.

Crea la clave

Selecciona Crear clave.

Copia la clave

Selecciona Copiar esta clave y guárdala en un lugar seguro. Es la única vez que la verás.

Confirma que la guardaste

Marca He guardado esta clave en un lugar donde puedo recuperarla. y luego selecciona Hecho — cerrar esto.

No veo Claves de API en Configuración

Solo los administradores de la cuenta pueden crear y revocar claves de API. Pídeselo a un administrador de tu cuenta.

El botón de copiar no funcionó

Puede que tu navegador haya bloqueado la copia. Selecciona la clave en la pantalla, cópiala a mano y luego marca la casilla para confirmar que la guardaste.

Si pierdes una clave

Orbit solo guarda un hash de la clave, así que nadie puede volver a mostrártela. Sustitúyela en este orden para que tu página de empleo no deje de funcionar:

1. Crea una clave de reemplazo.
2. Pon la clave nueva en tu página de empleo y comprueba que tus empleos siguen apareciendo.
3. Solo entonces revoca la clave antigua.

Puede haber dos claves activas a la vez, y eso es lo que permite hacer el cambio sin cortes.

Revocar una clave

En Claves de API, selecciona Revocar junto a la clave, lee qué dejará de funcionar y luego selecciona Revocar ahora. Se aplica a partir de la siguiente solicitud y no se puede deshacer.

Usar la clave

La documentación para desarrolladores cubre la autenticación, los endpoints y ejemplos. Empieza por Crear una clave de API en la documentación para desarrolladores de Wipperoz, o selecciona Leer la documentación de la API en la pantalla de Claves de API.