Accès à l'API Cintoo

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

Autorisations : les utilisateurs doivent disposer des autorisations appropriées pour accéder aux différentes ressources d'un projet Cintoo. Consultez les articles correspondant à une ressource pour connaître les autorisations requises.

Contactez support@cintoo.com pour toute question concernant les autorisations.

TABLE DES MATIÈRES

• Où trouver
• À propos des APIs Cintoo
• Authentification
• Cas d'utilisation
• Sandbox
• Restrictions du Sandbox
• Inscription au Sandbox pour les tests de l'API Cintoo

Où trouver

La documentation de l'API est accessible à tout moment en cliquant sur Documentation développeur dans le menu déroulant burger situé en haut à droite.

Interface de documentation de l'API Cintoo.

À propos des APIs Cintoo

Les APIs Cintoo permettent d'accéder à la plupart des ressources Cintoo. Les appels API actuels sont les suivants :

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

De nouveaux appels API sont ajoutés régulièrement dans la section API v2.

Authentification

1. Ouvrez l'invite de commandes (Power Shell 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

Cas d'utilisation

• Accès aux projets et aux scans depuis la plateforme GIS
• Connecter Cintoo au modèle Digital Twin
• Associer des tags à d'autres plateformes 1D, 2D, 3D ou ERP
• Gérer les utilisateurs Cintoo et les droits d'accès depuis l'annuaire d'entreprise

Sandbox

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

Le Sandbox est mis à votre disposition pour tester et utiliser les APIs sans impact sur les données de production (pas de suppression accidentelle par erreur, par exemple).

Restrictions du Sandbox

• Capacité de 20 scans par utilisateur
• Le SSO d'entreprise (le cas échéant) n'est pas applicable car le 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 le même e-mail, mais un nouveau mot de passe devra être défini 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/supprimer les données (contrairement à la plateforme de production)
• L'utilisation du 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 au Sandbox pour les API Testing Cintoo

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