Configurer l'API

HomeDocumentationCONFIGURERConfigurer l'API

Créer une requête sortante avec l’API

50 views /  0 like /   admin/

K inventory vous permet désormais d’envoyer automatiquement des données vers vos outils externes grâce à son module d’automatisation et son API universelle. Configurez des requêtes sortantes, ou webhooks, pour partager des informations clés de K inventory avec vos autres applications, sans avoir à écrire une seule ligne de code.

 

Vous devez créer une connexion pour chaque outil auquel vous souhaitez interagir avec K inventory 

 

Cette fonctionnalité n’est disponible que sur la version Web.

 

Qu’est-ce qu’une requête sortante (webhook) ?

Une requête sortante est envoyé par K inventory à une URL externe lorsque certains événements se produisent dans votre compte. Par exemple, vous pouvez configurer un webhook pour notifier votre logiciel de comptabilité chaque fois qu’une nouvelle vente est enregistrée dans K inventory.

 

1. Dans le menu de gauche, cliquez sur l’icône Paramètres Roue crantée.

 

2. Dans la section Automatisation, cliquez sur Requêtes (Webhooks).

 

 

menu api k inventoryMenu Automatisation

 

3. Cliquez sur le bouton Créer une requête.

 

Créer une requête sortante dans K inventoryCréer une requête

 

4. Dans Informations, complétez les informations permettant de configurer votre nouvelle requête entrante :

  • Nom de la requête
  • Statut: Activé ou Désactivé
  • Connexion : Sélectionnez une connexion préalablement créée dans Automatisation Connexion
  • Action de déclenchement: Sélectionnez l’événement dans K inventory qui déclenchera l’envoi du webhook (par exemple, « Nouvelle vente », « Mise à jour de stock », etc.).

 

action de déclenchement pour l'API de K inventoryListe des actions de déclenchement

 

  • Méthode:  Sélectionnez la méthode HTTP appropriée (GET, POST, PATCH, DELETE) en fonction de l’action que vous souhaitez effectuer sur l’outil externe.

 

  Liste des méthodes disponibles par rapport à vos données (interventions, références, dossiers, …) :

  • GET : Récupérer des informations depuis le serveur.
  • POST : Créer une nouvelle ressource sur le serveur.
  • PATCH : Mettre à jour partiellement une ressource existante sur le serveur
  • DELETE : Supprimer une ressource sur le serveur.

 

  • URL de la requête : Indiquez l’URL complète que K inventory doit appeler lorsqu’il envoie le webhook.
  • Valeur retournée:  Propriété à récupérer (exemple: entries.0.values.Request ID)

 

5. Dans Headers (facultatif), Si nécessaire, ajoutez des en-têtes spécifiques à votre requête en plus de ceux déjà définis dans la connexion :

  • Key : Content-Type
  • Value: Json

 

  Liste des modes de communications :

  • Jso
  • XML
  • Fichiers : Texte, Excel

 

6. Dans Conditions (facultatif), définissez des filtres pour n’envoyer le webhook que lorsque certaines conditions sont remplies (par exemple, uniquement pour les ventes d’un certain montant).

 

7. Dans Corps de la requête, sélectionnez les données de K inventory que vous souhaitez inclure dans le webhook en utilisant les variables disponibles.

 

Les variables proposées varient en fonction de l’action de déclenchement choisie.

 

8. Enregistrez vos changements avec le bouton Sauvegarder.

 

Pour continuer votre navigation, voici quelques articles en lien avec cette page :