API Reference
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.
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
Alta, baja, activación y actualización de las personas de tu organización.
La estructura donde viven esas personas: áreas, sedes, cargos y categorías de cargo.
Los atributos propios de tu organización, más allá del perfil estándar.
El catálogo vigente y la asignación de cursos y rutas a varias personas.
Actividad de aprendizaje agregada por persona: avance, quizzes y desempeño.
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.
Los dos headers, siempre juntos.
Hay dos estilos conviviendo. Cuál usa cada endpoint.
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.