Características de la Web API
La Web API de la versión 10 del ERP tiene algunas características propias que debe conocer antes de empezar a utilizar y que se mostrarán a continuación. Antes de empezar, necesita tener instalado el módulo de la Web API y el servidor IIS configurado y en funcionamiento. La Web API se ejecuta siempre en un servidor local, es decir, en la infraestructura del cliente. Otra particularidad de la Web API es que no tiene por qué estar instalada en la misma máquina del ERP Cegid. Puede instalar la Web API en un servidor dedicado, simplemente modificando la clave "ERPInstalationPath" en el Web.Config. La Web API ofrece los endpoints de servicio en un formato de rutas específico. Todas las rutas están construidas a semejanza de la API, para facilitar la comprensión de los distintos recursos. URL: La ruta siempre tiene la misma estructura con los siguientes elementos variables: Ejemplo: En el administrador del ERP, es posible controlar el acceso a los servicios de la Web API, teniendo en cuenta la configuración del perfil asignado al usuario. La Web API requiere la autenticación de todas las peticiones realizadas. El método de autenticación utilizado es el estándar OAuth 2.0. En la práctica, las peticiones a la Web API deben ir precedidas de una llamada a un endpoint, que realizará la autenticación del usuario y de la aplicación. Este endpoint es el siguiente: Los parámetros son los siguientes: La respuesta a esta petición proporcionará el enlace de redirección al endpoint con los datos de autenticación: Estos datos deben utilizarse en posteriores peticiones a la Web API, añadiendo los siguientes headers: El tiempo establecido para que caduque el token (expired_in) puede cambiarse en el archivo Web.config, en la configuración TokenExpirationMinutes: Cuando el token caduca, se devuelve un error 401 – Unauthorized con el mensaje "Authorization has been denied for this request." En este escenario, debe realizarse la petición de un nuevo token, utilizando el mismo método que en la primera petición (/token). Para garantizar que la renovación del token reutiliza el mismo contexto de integración, optimizando recursos y acelerando la respuesta, debe indicarse en el header de la solicitud el token anterior, que ya ha caducado (cabecera Authorisation).Instalación
End points de la Web API
http://localhost:2018/WebApi/{modulo}/{entidade}/{servico}/
http://localhost:2018/WebApi/Base/Clientes/Actualiza
Autenticación
http://localhost:2018/WebApi/token
Renovación de token
login para deixar a sua opinião.