Comment importer des données avec l'API?
Dans Importer des données, cliquez sur Importer à la ligne API, puis sur Nouvelle clé et choisissez Importer. Copiez la clé une seule fois et envoyez les enregistrements à partir d'un script. Chaque importation peut être annulée.
Ouvrez Importer des données, cliquez sur Importer à la ligne API, cliquez sur Nouvelle clé et choisissez Importer. Donnez la clé à votre développeur ou à votre script : elle envoie vos clients, entreprises, soumissions, travaux et factures vers votre application. Chaque importation s'affiche sous Importations récentes, où vous pouvez l'annuler.
Aussi appelé : API key, developer, script, integration, REST API, bulk import, migration from Jobber, clé API, développeur, importation par API
Utilisez cette méthode lorsque quelqu'un rédige un script pour transférer vos données depuis un autre outil. Chaque clé fonctionne uniquement pour votre application et écrit dans vos véritables données.
Étape 1 : Ouvrir la page de l'API
Dans le menu latéral, cliquez sur Importer des données. Sur la ligne API, cliquez sur Importer. La page API de données s'ouvre sous Connecteurs, où vous pourrez aussi la retrouver plus tard. Elle affiche votre URL de base, vos clés et un guide présentant les champs réels de votre application.
Cliquez sur : Importer des données › API › Importer
Étape 2 : Créer une clé
Cliquez sur Nouvelle clé et saisissez un Nom de la clé (par exemple « Migration Jobber »). Sous À quoi elle sert, choisissez Importer : elle ajoute et met à jour des enregistrements, et peut annuler ses importations. Cliquez sur Créer la clé. Cliquez immédiatement sur Copier : pour votre sécurité, elle ne sera plus affichée. Cliquez ensuite sur Terminé.
Cliquez sur : Nouvelle clé › Importer › Créer la clé › Copier
Étape 3 : Envoyer vos données
Donnez la clé et l'URL de base à votre développeur. Le guide Comment utiliser l'API sur la même page détaille chaque étape, avec des exemples de code et les champs réels de votre application. Les enregistrements s'affichent immédiatement dans votre CRM.
Cliquez sur : Comment utiliser l'API
Étape 4 : Vérifier ou annuler une importation
Sous Importations récentes, chaque importation indique combien d'enregistrements ont été ajoutés, mis à jour ou ont échoué. Pour en annuler une, cliquez sur Annuler, puis confirmez. Cela supprime les enregistrements ajoutés par cette importation. Les enregistrements auxquels votre équipe a ajouté des données depuis sont conservés.
Cliquez sur : Importations récentes › Annuler
Bon à savoir
Jusqu'à 500 enregistrements par requête, et 120 requêtes par minute par clé.
Envoyer à nouveau le même enregistrement le met à jour au lieu d'en créer une copie, donc un nouvel essai est sans risque.
Votre développeur peut d'abord faire un essai test : il vérifie chaque enregistrement et ne sauvegarde rien.
Pour désactiver une clé, cliquez sur Révoquer. Les scripts qui l'utilisent cessent immédiatement de fonctionner. Les enregistrements importés restent.
Si cela ne fonctionne pas
« La clé est manquante, incorrecte ou révoquée. » Créez une nouvelle clé et utilisez-la.
« La clé ne peut pas faire cela : une clé Rapports effectue uniquement des lectures, une clé Importation effectue uniquement des importations. » Créez une nouvelle clé avec l'option Importer sélectionnée.
« Votre application n'est pas encore prête pour l'API, ou l'importation est déjà annulée. » Votre application a peut-être besoin d'une mise à jour : ouvrez-la, publiez-la ou mettez-la à niveau, puis réessayez. Si vous venez d'annuler cette importation, il n'y a plus rien à faire.
« Plus de 500 enregistrements dans une seule requête. » Envoyez des lots plus petits.
« Trop de requêtes. Attendez une minute et réessayez. » Ralentissez la cadence à 120 requêtes par minute.
« Votre application n'a pas pu lister ses champs en ce moment. Réessayez dans une minute, ou appelez GET /objects. » Rechargez la page dans une minute.
« Un problème est survenu. Réessayez. » Réessayez dans un instant.