Comment importer des données avec l'API?
Dans Importer des données, cliquez sur Commencer sous API, puis sur Nouvelle clé. Copiez la clé une fois et envoyez les enregistrements à partir d'un script. Chaque importation peut être annulée.
Ouvrez Importer des données, cliquez sur Commencer sous API, puis cliquez sur Nouvelle clé. Donnez la clé à votre développeur ou à votre script : il envoie vos clients, entreprises, soumissions, travaux et factures à votre application. Chaque importation apparaît 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 écrit un script pour transférer vos données à partir d'un autre outil. Chaque clé fonctionne uniquement pour votre application et écrit dans vos vraies données.
Étape 1 : Ouvrir la page de l'API
Dans le menu latéral, cliquez sur Importer des données. Sur la fiche API, cliquez sur Commencer. La page API d'importation de données affiche votre URL de base, vos clés et un guide contenant les champs réels de votre application.
Cliquez sur : Importer des données › API › Commencer
Étape 2 : Créer une clé
Cliquez sur Nouvelle clé, entrez un Nom de clé (par exemple « Migration depuis Jobber »), puis cliquez sur Créer une clé. Cliquez sur Copier immédiatement : pour votre sécurité, elle ne sera plus affichée par la suite. Cliquez ensuite sur Terminé.
Cliquez sur : Nouvelle clé › Créer une 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 de votre application. Les enregistrements apparaissent 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 le nombre d'enregistrements ajoutés, mis à jour ou ayant échoué. Pour annuler une importation, cliquez sur Annuler, puis confirmez. Cela supprime les enregistrements ajoutés par cette importation. Les enregistrements auxquels votre équipe a apporté des ajouts 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, il est donc sécuritaire de réessayer.
Votre développeur peut d'abord effectuer un test : cela vérifie chaque enregistrement sans rien enregistrer.
Pour désactiver une clé, cliquez sur Révoquer. Les scripts qui l'utilisent cessent immédiatement de fonctionner. Les enregistrements importés restent en place.
Si cela ne fonctionne pas
« La clé est manquante, erronée ou révoquée. » Créez une nouvelle clé et utilisez-la.
« Votre application n'est pas encore prête pour les importations, ou l'importation a déjà été annulée. » Votre application pourrait avoir 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 rien d'autre à 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.