Savez-vous comment récupérer les données d’un formulaire avec notre API ?

 

PREREQUIS
  • Des connaissances minimums sur le fonctionnement de Kizeo Forms,
  • Des compétences en développement.

Si vous souhaitez récupérer des données saisies dans vos formulaires pour les insérer automatiquement dans votre CRM, votre ERP ou tout autre logiciel métier, il est nécessaire de passer par notre API. La démarche est simple mais nécessite de suivre un protocole précis. Ce processus est similaire à celui que l’on utilise lorsque l’on passe par le Back Office de Kizeo Forms.

1 – L’identification

Comme sur l’interface Web, la toute première étape consiste à s’identifier. Pour cela, il vous faut un Token. Il vous permettra d’accéder à vos données stockées sur nos serveurs par l’intermédiaire de notre API. Si vous n’en possédez pas je vous invite à lire le tutoriel « Comment débuter avec notre API ? »

2 – Récupérer la liste des données du formulaire.

Avec le Back Office, une fois que vous êtes connecté, allez dans l’historique des données, et sélectionnez votre formulaire pour afficher l’ensemble des enregistrements liés à ce formulaire. Avec l’API nous allons suivre le même chemin. Une fois le Token récupéré, vous pouvez accéder aux informations stockées sur nos serveurs. La procédure est similaire à celle utilisée avec l’interface Web. En effet pour accéder à vos données vous devez en premier lieu passer par l’historique. Ce dernier vous affiche l’ensemble des données liées à un formulaire.

Kizeoforms API Recuperer liste toutes donnees
Cette URL permet de récupérer la liste de toutes les données saisies d’un formulaire.
Kizeoforms API Recuperer liste donnees non lues
Cette URL permet de récupérer uniquement la liste des données qui n’ont pas encore été lues.

3 – Vous sélectionnez ensuite la donnée que vous souhaitez récupérer dans son intégralité.

Kizeoforms API Recuperer donnees completes
Cette URL vous permet de récupérer la donnée complète.

 

Vous trouverez toutes les informations pour utiliser ces requêtes.

4 – Les options

  • Afin d’éviter de lire de nouveau des données, vous pouvez les marquer comme lues.
Kizeoforms-API-Marquer-Donnees-Lues
Cette URL vous permet de marquer une donnée comme lue.

 

  • Le Web Service de Kizeo Forms vous offre également la possibilité de réaliser une recherche avancée sur vos données. Cette fonction vous permet d’obtenir la liste des données d’un formulaire qui répondent à une recherche spécifique sur un ou plusieurs champs.
N’hésitez pas à commenter cet article ! Nous sommes disponibles pour répondre à vos questions, suggestions, remarques, etc. !

Il y a 10 commentaires

  • Laurent

    16 Fév, 2022

    Bonjour,
    comment récupérer les informations par API pour une connexion avec SAGE .
    Dans l’attente..

    • Patrick Carloni

      16 Fév, 2022

      Bonjour Laurent,

      Nous ne sommes pas spécialistes Sage, mais nous pourrons toutefois vous guider dans l’utilisation de nos API.
      Dans tous les cas, je vous invite à prendre contact directement avec notre service support à support@kizeo.com.

      Je vous souhaite une bonne fin de journée.

  • ISSA IBRAHIM Moubarak

    14 Jan, 2022

    Bonjour s’il vous plait aide-moi j’ai une impasse j’veux récupérer les données api-platform dans une constance initialState

    //
    api{ « @context »: « /api/contexts/Article », « @id »: « /api/articles », « @type »: « hydra:Collection », « hydra:member »: [ { « @id »: « /api/articles/567 », « @type »: « Article », « id »: 567, « title »: « Vitamine A », « invoices »: [], « user »: « /api/users/56 », « description »: « test », « price »: 85.13, « quantity »: 1, « path »: « \ »C:\\Users\\Astuces\\Pictures\\mes images\\tn_Etudiant.jpg\ » » }, { « @id »: « /api/articles/639 », « @type »: « Article », « id »: 639, « title »: « Vitamine B », « invoices »: [], « description »: « VB », « price »: 65, « quantity »: 1, « path »: «  » }, { « @id »: « /api/articles/646 », « @type »: « Article », « id »: 646, « title »: « Vitamine B », « invoices »: [], « description »: « Bon Produit », « price »: 12, « quantity »: 1, « path »: «  » } ], « hydra:totalItems »: 3, « hydra:search »: { « @type »: « hydra:IriTemplate », « hydra:template »: « /api/articles{?id,id[],title,title[],description,description[],price,price[],quantity,quantity[],path,path[],order[id],order[title],order[description],order[price],order[quantity],order[path]} », « hydra:variableRepresentation »: « BasicRepresentation », « hydra:mapping »: [ { « @type »: « IriTemplateMapping », « variable »: « id », « property »: « id », « required »: false }, { « @type »: « IriTemplateMapping », « variable »: « id[] », « property »: « id », « required »: false }, { « @type »: « IriTemplateMapping », « variable »: « title », « property »: « title », « required »: false }, { « @type »: « IriTemplateMapping », « variable »: « title[] », « property »: « title », « required »: false }, { « @type »: « IriTemplateMapping », « variable »: « description », « property »: « description », « required »: false }, { « @type »: « IriTemplateMapping », « variable »: « description[] », « property »: « description », « required »: false }, { « @type »: « IriTemplateMapping », « variable »: « price », « property »: « price », « required »: false }, { « @type »: « IriTemplateMapping », « variable »: « price[] », « property »: « price », « required »: false }, { « @type »: « IriTemplateMapping », « variable »: « quantity », « property »: « quantity », « required »: false }, { « @type »: « IriTemplateMapping », « variable »: « quantity[] », « property »: « quantity », « required »: false }, { « @type »: « IriTemplateMapping », « variable »: « path », « property »: « path », « required »: false }, { « @type »: « IriTemplateMapping », « variable »: « path[] », « property »: « path », « required »: false }, { « @type »: « IriTemplateMapping », « variable »: « order[id] », « property »: « id », « required »: false }, { « @type »: « IriTemplateMapping », « variable »: « order[title] », « property »: « title », « required »: false }, { « @type »: « IriTemplateMapping », « variable »: « order[description] », « property »: « description », « required »: false }, { « @type »: « IriTemplateMapping », « variable »: « order[price] », « property »: « price », « required »: false }, { « @type »: « IriTemplateMapping », « variable »: « order[quantity] », « property »: « quantity », « required »: false }, { « @type »: « IriTemplateMapping », « variable »: « order[path] », « property »: « path », « required »: false } ] } }// const [item, setItem] = useState({ title: «  », description: «  », price: «  », quantity: «  », path: «  » }); useEffect(() => { const fetchData = async () => { const result = await articlesAPI.findAll(); const { item } = result.json(); setItem({ item }); }; fetchData(); }, [])

    //ma constante

    const initialState = {
    item: item,
    totalAmount: 0,
    totalItem: 0, };

    item me renvoyer un tableau vide s’il vous plaît comment le récupérer ???

    • Nathalie Castagnier

      14 Jan, 2022

      Bonjour,
      Compte tenu de la spécificité de votre demande, je vous invite à contacter notre équipe Support via l’adresse mail: support@kizeo.com.
      En vous souhaitant une bonne journée.
      Cordialement,
      Nathalie

  • Jean-André ROGER

    20 Août, 2020

    Bonjour,

    Est-il également possible de transmettre les exports (PDF en particulier) via l’API ?

    Merci d’avance

    • Kurt Carpels

      21 Août, 2020

      Bonjour,

      Oui, il est tout à fait possible de récupérer les PDF via l’API.
      Pour plus d’informations concernant l’API, n’hésitez pas nous contacter à support@kizeo.com

      Excellente journée,

      Kurt

  • jerome crevecoeur

    12 Sep, 2019

    Bonjour,
    Nous avons également besoin de créer des formulaires (pré remplir certaines données )
    Est-ce qu’il y a une possibilité via les apis ? (Push ?) ou c’est uniquement en maj ?

    Merci de votre réponse

    • Patrick Carloni

      12 Sep, 2019

      Bonjour,
      Il est effectivement possible de faire du Push de données par notre API. Je vous invite à lire la documentation ICI.
      En espérant avoir répondu à votre question.

  • Mourad

    24 Juin, 2019

    Bonjour,

    Merci pour cet article. Ce serait également intéressant de pouvoir automatiser le process de création de formulaires. Comptez-vous compléter l’API pour permettre ce cas d’usage ?

    Merci.

    • Charles Leconte

      24 Juin, 2019

      Bonjour,

      Merci pour cette proposition que nous notons même si à aujourd’hui ce cas d’usage n’est pas envisagé.

      Très bonne fin de journée à vous.

Poster un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *