Este proyecto contiene el código fuente de un ejemplo de integración con la API de SIIGO. Cubre cómo autenticarse y consumir métodos para obtener registros, insertar y eliminar.
Para poder ejecutar el siguiente proyecto requiere en su aplicación web.
- * jQuery -> https://ajax.googleapis.com/ajax/libs/jquery/3.3.1/jquery.min.js
- Bootstrap -> https://getbootstrap.com/
*Este requisito es indispensable, dado que el lenguaje usado es javascript sobre jQuery
A continuación los ejemplos de los métodos necesarios para interactuar con el API de SIIGO.
Para interactuar con el API es necesario usar la seguridad por token, para eso se debe consumir el servicio https://siigonube.siigo.com:50050/connect/token que solicita el usuario y contraseña; retornando finalmente el token que se usara en el resto de solicitudes.
Ejemplo con C#
public static async Task<string> getToken()
{
string token = "";
try
{
var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", TOKEN_BASIC);
client.DefaultRequestHeaders.Add("Accept", "application/json");
client.DefaultRequestHeaders.Add("Content-Type", "application/x-www-form-urlencoded");
var uri = "https://siigonube.siigo.com:50050/connect/token";
HttpResponseMessage response;
byte[] byteData = Encoding.UTF8.GetBytes(BODY_TOKEN_SERVICE);
using (var content = new ByteArrayContent(byteData))
{
content.Headers.ContentType = new MediaTypeHeaderValue("application/json");
response = await client.PostAsync(uri, content);
}
}
catch(Exception ex)
{
throw ex;
}
return token;
}
Una vez se obtiene el token, se puede realizar consultas a los métodos definidos en el API , a continuación un ejemplo de la solicitud por C#.
Ejemplo con C# (Obtener lista de desarrolladores)
public static async Task<List<Developer>> GetDevelopers()
{
List<Developer> result = null;
try
{
var client = new HttpClient();
client.DefaultRequestHeaders.Add("Ocp-Apim-Subscription-Key", SUBSCRIPTION_KEY);
client.DefaultRequestHeaders.Add("Authorization", await getToken());
var uri = "http://siigoapi.azure-api.net/siigo/api/v1/Developers/GetAll?namespace=v1";
HttpResponseMessage response = await client.GetAsync(uri);
result = Util.fromJson<List<Developer>>(response.Content.ReadAsStringAsync().Result);
}
catch (Exception ex)
{
throw ex;
}
return result;
}
Ejemplo con C# (Obtener lista de productos)
public static async Task<List<Product>> GetProducts()
{
List<Product> result = null;
try
{
var client = new HttpClient();
client.DefaultRequestHeaders.Add("Ocp-Apim-Subscription-Key", SUBSCRIPTION_KEY);
client.DefaultRequestHeaders.Add("Authorization", await getToken());
var uri = "http://siigoapi.azure-api.net/siigo/api/v1/Products/GetAll?numberPage=0&namespace=v1";
HttpResponseMessage response = await client.GetAsync(uri);
result = Util.fromJson<List<Product>>(response.Content.ReadAsStringAsync().Result);
}
catch (Exception ex)
{
throw ex;
}
return result;
}
Para realizar una eliminación es necesario enviar el id del objecto a eliminar, en este caso vamos a eliminar un producto.
Ejemplo con C#
public static async void DeleteProduct(long id)
{
try
{
var client = new HttpClient();
client.DefaultRequestHeaders.Add("Ocp-Apim-Subscription-Key", SUBSCRIPTION_KEY);
client.DefaultRequestHeaders.Add("Authorization", await getToken());
var uri = "http://siigoapi.azure-api.net/siigo/api/v1/Products/Delete/" + id + "?namespace=v1";
var response = await client.DeleteAsync(uri);
}
catch (Exception ex)
{
throw ex;
}
}
Para realizar una creación se requiere enviar los campos solicitados del objecto a crear.
Ejemplo con C#
public static async Task<Product> CreateProduct(Product product)
{
try
{
var client = new HttpClient();
client.DefaultRequestHeaders.Add("Ocp-Apim-Subscription-Key", SUBSCRIPTION_KEY);
client.DefaultRequestHeaders.Add("Authorization", await getToken());
var uri = "http://siigoapi.azure-api.net/siigo/api/v1/Products/Create?namespace=v1";
HttpResponseMessage response;
string productStr = Util.toJson(product);
byte[] byteData = Encoding.UTF8.GetBytes(productStr);
using (var content = new ByteArrayContent(byteData))
{
content.Headers.ContentType = new MediaTypeHeaderValue("application/json");
response = await client.PostAsync(uri, content);
product = Util.fromJson<Product>(response.Content.ReadAsStringAsync().Result);
}
}
catch (Exception ex)
{
throw ex;
}
return product;
}
En el proyecto se encuentra desarrollado con el framework Entity Framework 4.5 utilizando el lenguaje c#.
Se encuentran las siguientes carpetas y archivos
Controller
Model
Utils
Default.aspx
Default.aspx.cs
Default.aspx.designer.cs
packages.config
Web.config
Se encuentra en controlador de la aplicación.
Se encuentra los modelos utilizados en el llamado de los servicios.
Metodos globales necesarios para el procesamiento de los datos enviados y obtenidos de los servicios.
- Clonar el proyecto
- Configurar HTTPS en su computador Esto para evitar el error por CORS
- Debe tener .NET Framework 4.5 Instalar .Net Framework
- Ejecute los siguientes pasos para correr la aplicación sin necesidad de Visual Studio 2017 Ejecutar aplicación web ASP.NET desde la linea de comandos.
- Para ejecutar la aplicacion desde Visual Studio, abra el proyecto como una solucion desde el IDE.
- Abra la consola de administracion de paquetes de Visual Studio y ejecute el siguiente comando: Update-Package
- Pulse la tecla F5 para ejecutar la aplicación.