Abraxio API - Mise en route

Abraxio API - Mise en route

Préambule

Les API permettent d'interfacer votre SI avec Abraxio pour automatiser des processus, récupérer des données d'Abraxio ou intégrer des données dans Abraxio.
Les appels API sont sécurisés selon le protocole OAuth2.

Présentation des scopes

Au moment de créer vos accès API, vous pouvez choisir d'inclure dans votre accès tout ou partie du périmètre auquel votre souscription vous donne droit. La création d'un nouvel accès passe donc nécessairement par le choix de scopes associés. 
Voici un récapitulatif des scopes disponibles par souscription.
NB : l'indication "/*" sur une route API désigne "toutes les routes qui commencent par"

Souscription
Scope
Routes API
Description
API reportings
dataset.finance.read
- datasets/budgets/*
- datasets/timesheets
Liste des exercices budgétaires, lignes budgétaires, archives et arrêtés, commandes, factures
API reportings
dataset.portfolios.read
- datasets/projects/*
Liste des projets et de leur signalétique
API transactionnelles
management.read
- collaborators/absences
- timesheets
Liste des absences prévisionnelles et détail des feuilles de temps saisies
API transactionnelles
management.write
- collaborators/absences
Import des absences prévisionnelles pour un mois donné
API transactionnelles
finance.read
- orders/import
- invoices/import
État d'avancement de l'import des commandes/factures
API transactionnelles
finance.write
- orders/import
- invoices/import

Import des commandes/factures

 API transactionnelles
 suppliers.read
 - suppliers/*
 Lecture des fournisseurs
 API transactionnelles
 suppliers.write
 - suppliers/*
 Création / Édition des fournisseurs
 API transactionnelles
 portfolios.read
 - portfolios/*
 Lecture des portefeuilles, projets et activités
 API transactionnelles
 portfolios.write
 - portfolios/*
Création des projets et activités

Création d'un accès API

  1. Étape 1 : Accéder à Admin > Intégrations > API
  2. Étape 2 : cliquer sur "+ Ajouter un accès API" et renseigner le libellé de l'accès ainsi que le scope souhaité.
      
  1. Étape 3 : cliquer sur "Enregistrer". L'enregistrement génère automatiquement un jeton d'accès, constitué du couple de paramètres (clientId, clientSecret) :
    1. Le clientId (assimilable à un compte utilisateur) est un identifiant partagé entre le client et Abraxio.
    2. Le clientSecret (assimilable à un mot de passe) est connu uniquement du client.
  2. Étape 4 : copier le secret et garder le précieusement dans un espace sécurisé. Dès que vous aurez quitté la page, vous ne pourrez plus le récupérer.
  3. Étape 5 : tester les appels API en cliquant sur "Accéder à l'interface de test". Vous serez redirigé vers : api-docs.abraxio.com, vous permettant de tester la chaine de connexion, les API disponibles et la documentation associée :
    1. Cliquer sur Authorize, copier le ClientID et le Client Secret et cocher le(s) scope(s) souhaité(s)
    2. Cliquer sur l'API /v1/echo pour vérifier la validation de l'authentification
    3. Cliquer sur une API et renseigner les paramètres d'entrée pour examiner les flux JSON échangés
  4. Étape 6 : implémenter les appels API dans vos applicatifs.

Gestion des clés API

Vous pouvez créer plusieurs clés si vos règles d'architecture et d'urbanisme le nécessitent.
La désactivation suspend temporairement la validité de l'accès.
La suppression suspend définitivement la validité de l'accès.

Gestion des rappels



  1. Superviseur accès API : utilisateur Abraxio en charge de la supervision des accès API
  2. Autre destinataire : champ supplémentaire dans lequel vous pouvez renseigner une adresse email en complément du superviseur
  3. Délai de rappel des expirations : nombre de mois avant expiration à partir desquels Abraxio envoie un email par semaine au superviseur et à l'autre destinataire. Afin d'annuler le rappel, désactivez l'accès API concerné
Warning
Un accès API a une durée de validité limitée à 12 mois. Au terme, il faudra générer un nouvel accès et l'utiliser dans vos appels API.

    • Related Articles

    • Abraxio API - Généralités

      Deux catégories d'API sont mises à disposition dans Abraxio : 1. Les API transactionnelles (création et mise à jour de données Abraxio depuis vos outils) Objectifs : Intégration fine et temps réel d'informations ou Intégration en masse par lot de ...

    • Abraxio API - Tutoriel PowerBI

      Connecter vos données aux fichiers d'exemple Abraxio Etape 1 : Télécharger un des modèles en pièces jointes de cet article (en bas de page) : DemoAbraxio_v2.pbit ou DemoAbraxioBasic_v1.pbit DemoAbraxio_v2.1 : Si vous utilisiez déjà notre modèle ...

    • Import en masse des factures et temps passés

      Principes de fonctionnement Abraxio propose un dispositif d'import en masse des factures et des temps internes qui permet d'industrialiser le suivi du consommé de votre budget. Les grandes étapes du process sont : En amont, génération d'un fichier ...

    • Imports en masse

      Introduction Abraxio dispose de fonctionnalités d'import en masse pour les données suivantes : Imports des données de "Référentiel" (utilisés principalement lors de l'initialisation de la plateforme) Fournisseurs Interlocuteurs de vos fournisseurs ...

    • Gestion des équipes - Opérations en masse

      Accéder aux actions de mise à jour de vos équipes Pour simplifier la gestion de vos collaborateurs, Abraxio met à disposition des utilitaires qui permettent d'effectuer des opérations en masse sur vos équipes. Ces actions sont disponibles depuis ...