Conexio vitrine du développeur

API Avantage — employés

Lire les employés de Avantage depuis votre application, par une simple requête HTTP : pas de SDK, pas d’ODBC. Conexio relaie l’appel vers Avantage et vous répond en JSON — entité Employee.

✓ Lire (GET)✗ Créer (POST)✗ Modifier (PUT)

Lire les employés

Une requête GET sur /api/Entity/Employee, avec les modificateurs $select, $filter et $top. L’en-tête ALLOW_PAGINATION renvoie { Data, ResultsCount, TotalCount }.

HTTP
GET https://gateway.conexio.dev/api/Entity/Employee?$select=NoEmploye,NomEmploye,NoAssuranceSocial&$filter=NoEmploye eq 'VALEUR'&$top=10
Authorization: Basic base64(CODE_LICENCE:CLE_API)
COMPANY_CODE: VOTRE_COMPAGNIE
ALLOW_PAGINATION: true
curl
curl 'https://gateway.conexio.dev/api/Entity/Employee?$select=NoEmploye,NomEmploye,NoAssuranceSocial&$filter=NoEmploye%20eq%20'VALEUR'&$top=10' \
  -u "$CONEXIO_LICENCE:$CONEXIO_API_KEY" \
  -H 'COMPANY_CODE: VOTRE_COMPAGNIE' \
  -H 'ALLOW_PAGINATION: true'
JavaScript (fetch)
const response = await fetch("https://gateway.conexio.dev/api/Entity/Employee?$select=NoEmploye,NomEmploye,NoAssuranceSocial&$filter=NoEmploye%20eq%20'VALEUR'&$top=10", {
  headers: {
    Authorization: "Basic " + btoa(`${CODE_LICENCE}:${CLE_API}`),
    COMPANY_CODE: "VOTRE_COMPAGNIE",
    ALLOW_PAGINATION: "true",
  },
})
const { Data, TotalCount } = await response.json()
C# et Python
C# (HttpClient)
var http = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://gateway.conexio.dev/api/Entity/Employee?$select=NoEmploye,NomEmploye,NoAssuranceSocial&$filter=NoEmploye%20eq%20'VALEUR'&$top=10");
request.Headers.Authorization = new AuthenticationHeaderValue("Basic",
    Convert.ToBase64String(Encoding.UTF8.GetBytes($"{codeLicence}:{cleApi}")));
request.Headers.Add("COMPANY_CODE", "VOTRE_COMPAGNIE");
request.Headers.Add("ALLOW_PAGINATION", "true");
var json = await (await http.SendAsync(request)).Content.ReadAsStringAsync();
Python (requests)
import requests

response = requests.get(
    "https://gateway.conexio.dev/api/Entity/Employee?$select=NoEmploye,NomEmploye,NoAssuranceSocial&$filter=NoEmploye%20eq%20'VALEUR'&$top=10",
    auth=(CODE_LICENCE, CLE_API),
    headers={"COMPANY_CODE": "VOTRE_COMPAGNIE", "ALLOW_PAGINATION": "true"},
)
data = response.json()["Data"]

Filtrer

Les champs filtrables de Employee sur Avantage, et leurs opérateurs $filter :

ChampOpérateurs
NoEmployeeq ne contains
NoUniqueSystemeSourceeq ne contains
PrenomEmployeeq ne contains
NomEmployeeq ne contains
Adresse1eq ne contains
Villeeq ne contains
CodePostaleq ne contains
NoAssuranceSocialeq ne contains
Telephone1eq ne contains

Les champs

ChampLireCréerModifier
NoEmploye✓——
NoUniqueSystemeSource✓——
PrenomEmploye✓——
NomEmploye✓——
Adresse1✓——
Ville✓——
CodePostal✓——
NoAssuranceSocial✓——
Telephone1✓——

Les mêmes employés, dans les autres logiciels

Même requête, même JSON : seule la compagnie change.

Pour aller plus loin