Seamless API
Mit der Seamless REST API binden Sie Seamless in Ihre eigenen Systeme ein. Ein Projektportal oder ein ERP erstellt dann zum Beispiel für jedes neue Projekt automatisch ein Team, mit denselben Vorlagen, Namen und Regeln wie in der Seamless App.
Im Seamless API Explorer ↗ (opens in a new tab) sehen Sie alle Endpunkte und testen sie direkt mit Ihrem Microsoft 365 Tenant.
Die Grundlagen
| Thema | Angabe |
|---|---|
| Adresse | https://sml-api.io |
| Format | JSON |
| Anmeldung | Bearer Token im Header Authorization, gültig während 24 Stunden |
In allen Beispielen erstellen wir in der Organisation Contoso mit der Vorlage Projekt das Team 260215.001 - Projekt Atlas.
In drei Schritten zum ersten Aufruf
API Key erstellen
Erstellen Sie im Admin Center unter Settings > API keys einen neuen Key und speichern Sie das Secret sicher. Es wird nur einmal angezeigt. Anleitung: API Keys
Access Token abrufen
Tauschen Sie Tenant ID, Key Id und Secret gegen ein Access Token. Anleitung: Access Token abrufen
API aufrufen
Senden Sie das Token bei jedem Aufruf im Header mit:
GET https://sml-api.io/organisations
Authorization: Bearer eyJ0eXAiOiJKV1Qi...Die Antwort zeigt Ihre Organisationen. Damit sind Sie bereit, zum Beispiel ein Team zu erstellen.
Die Endpunkte
| Endpunkt | Wofür |
|---|---|
POST /token | Access Token abrufen |
GET /organisations | Alle Organisationen auflisten |
GET /organisations/{idOrIdentifier} | Eine Organisation mit ihren Vorlagen abrufen |
POST /teams | Team aus einer Vorlage erstellen |
PATCH /teams/{teamId}/name | Namen eines Teams ändern |