Tomorro stellt eine öffentliche GraphQL-API bereit, mit der Sie sowohl Daten empfangen als auch senden können.
Die Möglichkeiten sind vielfältig und erlauben es Ihnen, nahezu alle Operationen auf unserer Plattform durchzuführen. Es handelt sich um dieselbe API, die wir intern für die Entwicklung unserer Anwendungen und die Anbindung an andere Tools verwenden.
⚠️ Unsere API V1 (GraphQL) wird abgekündigt. Wenn Sie ein neues Integrationsprojekt starten, empfehlen wir Ihnen, API V2 (REST) zu verwenden : https://alpha.developer.tomorro.com/quickstart
Entwicklerdokumentation
Unsere API-Dokumentation: https://developers.tomorro.com/welcome
Queries → Alle Möglichkeiten zur Datenabfrage aus Tomorro an Drittanbieter-Software
Mutations → Alle Möglichkeiten zur Datenübermittlung von Drittanbieter-Software an Tomorro
Unsere Webhook Dokumentation: Verwendung / Technische Dokumentation
Was die V2-API (REST) abdeckt
Mit der V2-API können Sie insbesondere:
Mitglieder: alle Mitglieder Ihrer Organisation auflisten (GET /v2/members), ein Mitglied abrufen (GET /v2/members/:id), Mitglieder erstellen oder aktualisieren.
Benutzerdefinierte Tabellen (Custom Objects): Ihre Tabellen auflisten (GET /v2/custom-objects), die Struktur und Spalten einer Tabelle lesen (GET /v2/custom-objects/:id), Zeilen einer Tabelle in einem Vertrag hinzufügen oder aktualisieren (PUT /v2/custom-objects/:customObjectId/contract/:contractId/records).
Verträge: Verträge auflisten und lesen, einschließlich der Werte ihrer benutzerdefinierten Felder (GET /v2/contracts, GET /v2/contracts/:id).
Benutzerdefinierte Felder: Felder auflisten (GET /v2/smart-fields) und die Optionen von Listenfeldern (GET /v2/smart-fields/:id/options).
Das Lesen der Zeilen einer benutzerdefinierten Tabelle ist über die API noch nicht verfügbar (nur das Schreiben). Die vollständige Liste der Endpunkte und ihre Schemata finden Sie in der V2-Entwicklerdokumentation.
Glossar
API-Name | Tomorro-Name |
type | Vertragstypen |
template | Vorlage |
contract | Vertrag |
document | Vertragsdokument |
externalCompany | Gegenpartei |
attributeDefinition | Smart Field |
Authentifizierung & Einrichtung
Endpoint : https://api.tomorro.com/graphql
Content-Type : application/json
X-API-KEY : IhrAPISchlüssel
Ein persönlicher API-Schlüssel kann direkt in der Tomorro-Anwendung generiert werden:
Gehen Sie zu
https://app.tomorro.com/integrationsNavigieren Sie zum Bereich API > API-Schlüssel generieren
Tipps
Alle IDs finden Sie direkt in der URL (verfügbar für Vertragstypen, Verträge, Gegenparteien usw.).
Der "GraphQL Network Inspector" hilft Ihnen dabei, alle Live-Anfragen während der App-Nutzung zu visualisieren:
Erweiterung herunterladen
Tomorro öffnen > Rechtsklick > Untersuchen
Tab „GraphQL Network" öffnen
