API Reference | Crehana Developers

Todas las operaciones de la API pública viven bajo el mismo prefijo y se autentican igual. Lo que cambia de una sección a otra es el recurso, no la forma de llamar.

https://www.crehana.com/api/v5/rest/org/{organization_slug}/

El {organization_slug} es el identificador de tu organización dentro de las rutas. Si tu espacio es https://www.crehana.com/org/acme/, tu slug es acme. Unas pocas operaciones —las de autenticación— no lo llevan.

Cada operación de esta sección trae un botón Try it. Pegá tus credenciales una vez en el panel de autenticación y quedan para todas las demás llamadas de la sesión. El selector de la esquina del bloque de código te da el mismo request en cURL, Python, JavaScript, Go, Java, PHP, Ruby y C#.

Cómo está organizada

Users

Alta, baja, activación y actualización de las personas de tu organización.

Organizations

La estructura donde viven esas personas: áreas, sedes, cargos y categorías de cargo.

Custom Fields

Los atributos propios de tu organización, más allá del perfil estándar.

Learning V2

El catálogo vigente y la asignación de cursos y rutas a varias personas.

Reports

Actividad de aprendizaje agregada por persona: avance, quizzes y desempeño.

Time Off

Consulta y cancelación de las solicitudes de ausencia.

Lo que conviene saber antes

Estas tres cosas valen para toda la API, así que se escriben una vez y no hay que volver a pensarlas endpoint por endpoint.

Autenticación

Los dos headers, siempre juntos.

Paginación

Hay dos estilos conviviendo. Cuál usa cada endpoint.

Errores

Qué significa cada status y qué reintentar.

Secciones marcadas como deprecadas

Algunas operaciones aparecen con la etiqueta Deprecated. Siguen respondiendo con normalidad —no se rompe nada si tu integración las usa— pero tienen un reemplazo mejor y van a retirarse. Cada una dice cuál es su sucesor en su propia página.

Si estás empezando una integración, no construyas sobre ellas. Cómo se anuncian y se retiran está en Versionado y deprecaciones.