Accéder à Cintoo API

Cet article décrit les possibilités d'accès aux ressources Cintoo via Cintoo API.

Contactez support@cintoo.com pour toute question relative aux autorisations.

TABLE DES MATIÈRES

• Où trouver la documentation
• À propos de Cintoo API
• Authentification
• Cas d'usage
• Sandbox
• Restrictions de la Sandbox
• Inscription à la Sandbox pour tester Cintoo API

Où trouver la documentation

La documentation de l'API est accessible à tout moment en cliquant sur Documentation pour les développeurs dans le menu déroulant burger situé dans le coin supérieur droit.

Interface de la documentation de Cintoo API.

À propos de Cintoo API

Cintoo API permet d'appeler la plupart des ressources Cintoo. Les appels d'API actuellement disponibles sont les suivants :

• Vérifier si l'utilisateur est connecté
• Lister ou obtenir les comptes Cintoo
• Lister ou obtenir les projets Cintoo
• Obtenir des rapports sur la date du dernier accès à un projet ou sur la dernière activité d'un utilisateur
• Déplacer un projet vers un autre abonnement
• Lister les fichiers, y compris les scans, les modèles et les GeoImages
• Lister, créer, mettre à jour ou supprimer des balises ou des listes de balises
• Créer des paramètres Cintoo Connect pour l'import et l'export
• Lister ou obtenir des groupes d'utilisateurs
• Lister ou obtenir les rôles
• Lister les abonnements
• Lister ou obtenir les utilisateurs

D'autres appels d'API sont ajoutés régulièrement dans la section API v2.

Authentification

1. Ouvrez l'invite de commandes (PowerShell ou CMD).
2. Accédez au dossier de téléchargement.
3. Exécutez la commande suivante :

.\cintoo-login-1.1.0-signed.exe --url https://eu.cintoo.cloud

Assurez-vous que le bon domaine est utilisé.

Pour plus d'informations, consultez Authentication API.

Cas d'usage

• Accès aux projets et aux scans depuis une plateforme SIG
• Connexion de Cintoo avec le modèle de jumeau numérique
• Liaison des balises avec d'autres plateformes 1D, 2D, 3D ou ERP
• Gestion des utilisateurs et des droits d'accès de Cintoo à partir de l'annuaire de l'entreprise

Sandbox

Cintoo API s'accompagne d'une Sandbox, c'est-à-dire d'un environnement de test. Cette Sandbox est un tenant distinct de la plateforme Cintoo que vous connaissez déjà.

La Sandbox est mise à votre disposition afin de tester et d'utiliser les API sans conséquence sur les données de production (pas de suppression accidentelle par erreur, par exemple).

Restrictions de la Sandbox

• Capacité de 20 scans par utilisateur
• Le SSO d'entreprise (le cas échéant) n'est pas applicable, car la Sandbox utilise un compte différent
• Veuillez contacter support@cintoo.com pour obtenir le lien d'invitation au compte Sandbox
• Il est possible d'utiliser la même adresse e-mail, mais il vous sera demandé de définir un nouveau mot de passe en cliquant sur le lien d'invitation
• Veuillez noter qu'il s'agit d'une plateforme expérimentale ; nous nous réservons donc le droit d'actualiser ou de supprimer les données (contrairement à la plateforme de production)
• L'utilisation de la Sandbox n'est pas limitée dans le temps
• N'hésitez pas à utiliser des modèles BIM ou CAD dans cet environnement de test

Inscription à la Sandbox pour tester Cintoo API

Veuillez contacter notre équipe Support à l'adresse support@cintoo.com pour être invité à la Sandbox et obtenir toute la documentation de Cintoo API.