Zugriff auf die Cintoo API

Dieser Artikel beschreibt die Möglichkeiten, über die Cintoo API auf Cintoo-Ressourcen zuzugreifen.

Bei Fragen zu Berechtigungen wenden Sie sich an support@cintoo.com.

INHALTSVERZEICHNIS

• Wo Sie die Dokumentation finden
• Über die Cintoo APIs
• Authentifizierung
• Anwendungsfälle
• Sandbox
• Einschränkungen der Sandbox
• Für die Sandbox zum Testen der Cintoo API registrieren

Wo Sie die Dokumentation finden

Die API-Dokumentation ist jederzeit abrufbar: Klicken Sie dazu auf Entwicklerdokumentation im Hamburger-Dropdown-Menü oben rechts.

Oberfläche der Dokumentation zur Cintoo API.

Über die Cintoo APIs

Mit den Cintoo APIs lassen sich die meisten Cintoo-Ressourcen abrufen. Aktuell stehen die folgenden API-Aufrufe zur Verfügung:

• Prüfen, ob der Nutzer angemeldet ist
• Cintoo-Konten auflisten oder abrufen
• Cintoo-Projekte auflisten oder abrufen
• Berichte zum letzten Projektzugriff oder zur letzten Nutzeraktivität abrufen
• Projekt in ein anderes Abonnement verschieben
• Dateien auflisten, einschließlich Scans, Modelle und GeoImages
• Tags oder Tag-Listen auflisten, erstellen, aktualisieren oder löschen
• Parameter von Cintoo Connect für Import und Export erstellen
• Nutzergruppen auflisten oder abrufen
• Rollen auflisten oder abrufen
• Abonnements auflisten
• Nutzer auflisten oder abrufen

Weitere API-Aufrufe werden regelmäßig im Abschnitt API v2 ergänzt.

Authentifizierung

1. Öffnen Sie die Eingabeaufforderung (PowerShell oder CMD).
2. Wechseln Sie in den Download-Ordner.
3. Führen Sie den folgenden Befehl aus:

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

Stellen Sie sicher, dass die richtige Domain verwendet wird.

Weitere Informationen finden Sie unter Authentication API.

Anwendungsfälle

• Zugriff auf Projekte und Scans von einer GIS-Plattform aus
• Cintoo mit dem Digital-Twin-Modell verbinden
• Tags mit anderen 1D-, 2D-, 3D- oder ERP-Plattformen verknüpfen
• Cintoo-Nutzer und Zugriffsrechte über das Unternehmensverzeichnis verwalten

Sandbox

Zur Cintoo API gehört eine Sandbox, also eine Testumgebung. Diese Sandbox ist ein eigenständiger Tenant, der von der Cintoo-Plattform, die Sie bereits kennen, getrennt ist.

Die Sandbox steht Ihnen zur Verfügung, um APIs zu testen und zu verwenden, ohne dass sich dies auf die Produktivdaten auswirkt (zum Beispiel kann nichts versehentlich gelöscht werden).

Einschränkungen der Sandbox

• Scankapazität von 20 Scans pro Nutzer
• Das Unternehmens-SSO (sofern vorhanden) ist nicht anwendbar, da die Sandbox ein anderes Konto verwendet
• Wenden Sie sich an support@cintoo.com, um den Einladungslink zum Sandbox-Konto zu erhalten
• Es ist möglich, dieselbe E-Mail-Adresse zu verwenden, allerdings muss über den Einladungslink ein neues Passwort festgelegt werden
• Bitte beachten Sie, dass es sich um eine experimentelle Plattform handelt. Wir behalten uns daher das Recht vor, die Daten zurückzusetzen oder zu löschen (anders als auf der Produktivplattform)
• Die Nutzung der Sandbox ist zeitlich nicht begrenzt
• In dieser Testumgebung können Sie gerne BIM- oder CAD-Modelle verwenden

Für die Sandbox zum Testen der Cintoo API registrieren

Wenden Sie sich an unser Support-Team unter support@cintoo.com, um zur Sandbox eingeladen zu werden und die gesamte Dokumentation zur Cintoo API zu erhalten.