Contact

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

Accueil / Kize'Astuces/Savez-vous comment récupérer les données d’un formulaire avec notre API ?

Catégorie / Kize'Astuces, Tutoriels Étiquettes : API, Récuperation données, Token, Web Service Par Patrick Carloni

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.

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.

Cette URL vous renvoie vers la recherche avancée. Vous trouverez toutes les informations pour utiliser cette requête.

N’hésitez pas à commenter cet article ! Nous sommes disponibles pour répondre à vos questions, suggestions, remarques, etc. !

Il y a 14 commentaires

Thomas

18 Juin, 2024

Bonjour,

Comment récupérer la photo par l’API apres un POST https://forms.kizeo.com/rest/v3/forms/xxxxx/data/advanced ?
Dans la réponse, j’ai un « photo2 »: « xxxxxxxxxxxxxxxxx_aaaammjjhhmmss_xxxxxxxxx-xxxxx-xxxxx-xxxxx-xxxxxxx.jpg »,
Mais je sais pas ou et comment la récupérer 🙁
En vous remerciant par avance !
- Bastien Galzot
  
  19 Juin, 2024
  
  Bonjour Thomas,
  
  Étant donné la spécificité de votre demande, je vous invite à nous contacter directement à l’adresse support@kizeo.com en mentionnant les éléments suivants :
  
  – Code Entreprise
  – Identifiant de la donnée concernée (Data ID)
  – Nom / Id du formulaire
  
  Bonne journée,
  
  Bastien
Sébastien Istasse

02 Mai, 2024

Bonjour,

Je voulais savoir s’il était possible de faire un push via API d’un champs photo ?
Le but étant de réaliser un interfacage entre 2 dossiers Kizéo différent.

Cordialement,
- Patrick Carloni
  
  13 Mai, 2024
  
  Bonjour Sébastien,
  À aujourd’hui, il n’est pas possible de Pusher des médias par API.
  Peut-être que le Transfert Auto et le Push Auto pourraient répondre à votre besoin.
  
  Je vous souhaite une bonne journée.
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.