Uso de la API para interoperabilidad
Consideraciones iniciales
Se incluye aquí un conjunto de pasos, técnicas y recomendaciones que describen la forma de integrar aplicaciones con la API de Araí-Usuarios.
Araí-Usuarios en la versión 3.0 introduce el versionado de API por URL. Es decir /<url-modulo-api>/api/v2. Haciendo que Arai-Usuarios menor a v3 se
considere sus API como legacy.
La versión actualmente recomendada de la API es la v2. Si está operando contra cualquier otra, vea la sección de migración correspondiente.
Versiones soportadas
Se soporta actualmente las versiones de API, a travéz de diferentes versiones del producto
- API v2 (en Araí-Usuarios v3.0)
- API v1 (en Araí-Usuarios v3.0)
- API Legacy (en Araí-Usuarios v2.3)
Documentación
La API esta publicada en https://documentacion.siu.edu.ar/apis/
Clientes
Prograrmar cliente
@TODO
Cliente Swagger
@TODO levantar un swagger-up + arai-usuarios demo + interactuar
Como usar
@TODO describir los flujos y/o recursos mas importantes
Migrar de versiones
Si implementa una versón previa de la API, existen cambios entre una y otra. A continuación se listan las guías respectivas:
- API Legacy (Arai-Usuarios 2.3, el endpoint estaba integrado en el IDM). No requiere migración. Apuntar a URL nueva en
versión
v1. - API v1 a v2. Seguir los pasos de esta guía detallada.