API do Libax Business

using System;
using System.Net.Http;
using System.Text;
using System.Text.Json;
using System.Threading.Tasks;

using HttpClient client = new HttpClient();
string url = "https://id.libax.com/api/connect/token";
string clientId = "YOUR-CLIENTID";
string clientSecret = "YOUR-SECRET";

string encodedCredentials = Convert.ToBase64String(Encoding.ASCII.GetBytes(clientId + ":" + clientSecret));
client.DefaultRequestHeaders.Add("Authorization", "Basic " + encodedCredentials);

var content = new StringContent("grant_type=client_credentials&scope=business_public_api", Encoding.UTF8, "application/x-www-form-urlencoded");

using HttpResponseMessage response = await client.PostAsync(url, content);

if (response.IsSuccessStatusCode)
{
    string responseData = await response.Content.ReadAsStringAsync();
    dynamic t = Newtonsoft.Json.JsonConvert.DeserializeObject(responseData);

    string accessToken = t.access_token;
    int expiresIn = t.expires_in;
    string tokenType = t.token_type;
    string scope = t.scope;

    Console.WriteLine($"Access Token: {accessToken}, Expires in {expiresIn}, type {tokenType}, scope {scope}");
}
else
{
    Console.WriteLine($"Error: {response.StatusCode}");
}

Exemplo para obter lista de 10 produtos

Utilização do método em https://api.libax.com/business/v1/index.html#/Products/get_Products

using HttpClient client = new HttpClient();
string url = "https://api.libax.com/business/v1/products";

client.DefaultRequestHeaders.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", "YOUR-ACCESS-TOKEN");

var queryParams = new System.Collections.Generic.Dictionary<string, string> { { "take", "10" } };

using FormUrlEncodedContent formContent = new FormUrlEncodedContent(queryParams);
string queryString = await formContent.ReadAsStringAsync();

using HttpResponseMessage response = await client.GetAsync($"{url}?{queryString}");

if (response.IsSuccessStatusCode)
{
    string data = await response.Content.ReadAsStringAsync();
    Console.WriteLine(data);
}
else
{
    Console.WriteLine($"Error: {response.StatusCode}");
}

using HttpClient client = new HttpClient();
string url = "https://api.libax.com/business/v1/entities";

client.DefaultRequestHeaders.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", "YOUR-ACCESS-TOKEN");

var data = new
{
    name = "Ana Ferreira",
    city = "Lisboa"
};
using StringContent content = new StringContent(JsonSerializer.Serialize(data), Encoding.UTF8, "application/json");

using HttpResponseMessage response = await client.PostAsync(url, content);

if (response.IsSuccessStatusCode)
{
    string newEntityId = await response.Content.ReadAsStringAsync();
    Console.WriteLine(newEntityId);
}
else
{
    Console.WriteLine($"Error: {response.StatusCode}");
}

using HttpClient client = new HttpClient();
string url = "https://api.libax.com/business/v1/Entities/search";

client.DefaultRequestHeaders.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", "YOUR-ACCESS-TOKEN");

var data = new
{
    take = 5,
    filters = new[]
    {
        new { propertyName = "creationdate", @operator = "GTE", value = "2022-01-01" },
        new { propertyName = "creationdate", @operator = "LT", value = "2023-01-01" }
    }
};

using StringContent content = new StringContent(JsonSerializer.Serialize(data), Encoding.UTF8, "application/json");

using HttpResponseMessage response = await client.PostAsync(url, content);

if (response.IsSuccessStatusCode)
{
    string newEntityId = await response.Content.ReadAsStringAsync();
    Console.WriteLine(newEntityId);
}
else
{
    Console.WriteLine($"Error: {response.StatusCode}");
}

{
  "take": 50,
  "skip": 0,
  "filters": [
    {
      "propertyName": "name",
      "operator": "CONTAINS_TOKEN",
      "value": "Ana"
    }
  ],
  "sort": {
    "propertyName": "creationDate",
    "direction": 1
  }
}

Procura por entidades criadas no ano 2022

{
  "take": 50,
  "skip": 0,
  "filters": [
    {
      "propertyName": "creationdate",
      "operator": "GTE",
      "value": "2022-01-01"
    },
    {
      "propertyName": "creationdate",
      "operator": "LT",
      "value": "2023-01-01"
    }
  ]
}

{
  "take": 50,
  "skip": 0,
  "filterGroups": [
    {
      "filters": [
        {
          "propertyName": "city",
          "operator": "EQ",
          "value": "Lisboa"
        }
      ]
    },
    {
      "filters": [
        {
          "propertyName": "city",
          "operator": "EQ",
          "value": "Porto"
        }
      ]
    }
  ]
}

{
  "take": 50,
  "skip": 0,
  "filterGroups": [
    {
      "filters": [
        {
          "propertyName": "city",
          "operator": "EQ",
          "value": "Lisboa"
        }
      ]
    },
    {
      "filters": [
        {
          "propertyName": "city",
          "operator": "EQ",
          "value": "Porto"
        }
      ]
    }
  ],
  "filters": [
    {
      "propertyName": "creationdate",
      "operator": "GTE",
      "value": "2023-01-01"
    }
  ]
}

Limites de utilização

A API está protegida com um número de requests por minuto:

• 100 requests por minuto todos os dias entre as 9h e as 19h (hora de Portugal continental)
• 200 requests por minuto todos os dias entre as 19h e as 9h (hora de Portugal continental)

Em todos os responses, irá obter os seguintes headers:

• X-Rate-Limit - indica quantos requests já fez desde que o contador voltou a zero
• X-Rate-Limit-Remaining - indica quantos requests ainda pode fazer dentro do minuto a decorrer

Dica: Utilize estes headers para não exceder o número de requests permitidos por minuto.

Se exceder o limite de requests por minuto, irá obter um erro 429 com o header Retry-After que indica o tempo no formato delta-seconds que tem de esperar para que possa fazer um novo request.

Dúvidas e apoio ao desenvolvimento

Se durante o desenvolvimento surgirem dúvidas ou pretende ajudar no desenvolvimento, não hesite em contactar-nos pelo e-mail support@libax.com