Accès à l'API Cintoo

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

Permissions : les utilisateurs doivent avoir les permissions appropriées pour accéder aux différentes ressources d'un projet Cintoo. Consultez les articles correspondant à une ressource pour voir quelles permissions sont requises.

Contactez support@cintoo.com en cas de questions concernant les permissions.

TABLE DES MATIÈRES

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

Où trouver

La documentation de l'API peut être trouvée à tout moment en cliquant sur Documentation pour développeurs dans le menu déroulant burger en haut à droite.

Interface de documentation de l'API Cintoo.

À propos des API Cintoo

Les API 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 dernière date d'accès au projet ou la dernière activité de l'utilisateur
• Transférer le projet vers un autre abonnement
• Lister les fichiers, y compris les Scans, les Modèles, les GeoImages
• Lister, créer, mettre à jour ou supprimer des Tags ou des Listes de Tags
• Créer des paramètres de connexion Cintoo 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

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

Authentification

1. Ouvrez l'invite de commande (Power Shell ou CMD).

2. Naviguez vers le 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éder aux projets et scans depuis la plateforme SIG
• Connecter Cintoo avec le modèle de Jumeau Numérique
• Lier les tags à d'autres plateformes 1D, 2D, 3D ou ERP
• Gérer les utilisateurs Cintoo et les droits d'accès depuis l'annuaire de l'entreprise

Sandbox

Avec l'API Cintoo vient 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 à votre disposition pour tester et utiliser les API sans conséquence sur les données de production (pas de suppression malencontreuse par exemple).

Restrictions Sandbox

• Capacité de scan de 20 scans par utilisateur
• Le SSO de l'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 email mais le nouveau mot de passe sera demandé 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 de rafraîchir/supprimer les données (contrairement à la plateforme de production)
• Il n'y a pas de limite de temps pour utiliser le Sandbox
• N'hésitez pas à utiliser des modèles BIM ou CAD dans cet environnement de test

Enregistrement au Sandbox pour les tests de l'API Cintoo

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