Wie man Mitarbeiter zu Plecto über die API hinzufügt
POST-Anfrage zum Erstellen von Mitgliedern in Plecto
Endpoint: https://app.plecto.com/api/v2/members/
POSTen Sie eine Anfrage wie im obigen Beispiel gezeigt. Diese Anfrage enthält die minimalen Schlüssel, um einen Benutzer (Mitglied/Mitarbeiter) in Plecto ohne Anmeldezugang zu erstellen.
Hier ist eine Aufschlüsselung der einzelnen Schlüssel:
-
"updating_api_provider_id": "API-Anbieter-ID"
- Dies wird als externe ID im Mitarbeiterprofil angezeigt. Sobald gesendet, können Sie diesen Namen nicht mehr überschreiben.
-
"updating_api_provider": "MEINE API"
- Dies wird der Systemname sein, auch bekannt als Datenanbieter. Wenn Sie diesen Schlüssel aktualisieren und eine neue Anfrage senden, während Sie die anderen Schlüssel gleich lassen, wird das Mitarbeiterprofil in Plecto einen neuen Datenanbieter zur Liste hinzufügen.
-
"updating_api_provider_email": "api.email@example.com"
- Dies ist die Benutzer-E-Mail. Sobald gesendet, ist es nicht möglich, die E-Mail zu überschreiben (zum Beispiel, wenn Sie die E-Mail auf api.email_new@exaple.com aktualisieren).
-
"name": "John Doe"
- Dies ist der Name des Benutzers. Mehrere Namen werden automatisch in Vor- und Nachnamenfelder aufgeteilt. Sie können es leicht überschreiben.
-
"is_active": true
- Um einen Benutzer zu deaktivieren, setzen Sie diesen Schlüssel auf false.
-
"teams": []
- Dies ist ein obligatorischer Schlüssel, aber Sie können ihn leer lassen. Wenn Sie Teams angeben möchten, überprüfen Sie den https://app.plecto.com/api/v2/teams/ Endpoint und fügen Sie die IDs Ihrer Teams hinzu. Bei mehreren Teams trennen Sie diese mit einem Komma.
Sie können andere, nicht erforderliche Schlüssel hinzufügen (Sie werden eine Liste von Schlüsseln in der Anfrageantwort sehen, aber nur die unten aufgeführten Schlüssel erlauben Ihnen das Schreiben):
-
"title": "Senior API-Spezialist"
-
"display_name": "Anchorman"
-
"manager": "e1c111ebbc1111be1cbb1c111ced1111"
-
"managed_teams": []
Wie man Mitarbeiter über die API zu Plecto einlädt
Im vorherigen Schritt haben wir gezeigt, wie man einen Mitarbeiter ohne Anmeldezugang erstellt. Hier sehen Sie ein Anfragebeispiel, wenn Sie einen Mitarbeiter zu Plecto einladen möchten.