Login mit API-Token

Owned by Julian Hitl
Last updated: März 04, 2024
2 min read

Mit Ihrem in TeamWork 365 generierten API-Token können Sie sich nun an der TeamWork 365 API anmelden.
Hierbei haben Sie die Möglichkeit einen neuen Access-Token anzufordern oder bestehende Tokens zu erneuern.

Neuen Access Token anfordern:

Request

[POST] <TeamWork 365-Url>/login { "Username": "max.mustermann@example.org", "Password": "w64skWMX5VQUV0kgoFlUYAuFTIgKRseiA6UA1askbjr6skCZj6M_R4QbF28YbiOJx623uyBC7o" }

Parameter:

  • Username: Ihre E-Mail Adresse, mit der Sie sich auch via Microsoft Identifizieren

  • Password: Ihr API-Token, den Sie sich in TeamWork 365 generiert haben

Response

{ "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJ6U2RMdWd4eVNyd1hiOHd6VVc0MmE3YlZXcXN123FVUJXMGZmbXdFR0hpeW123I0In0.eyJleHAiOjE3MDkyOTUwOTQsImlhdCI6MTcwOTI4MDY5NCwianRpIjoiMTY1NmQzNzMtOGU3MS00NmRkLTg4ZTktNzkyM2ZmNmM4YjAxIiwiaXNzIjoiaHR0cHM6Ly9pZC5uZXVtZWllci1lZHYuZGUvYXV0aC9yZWFsbXMvVGVzdCIsInN1YiI6IjhlMTZlNGI1LTZhNmEtNDRjOS1hYWM0LWE4YThkNjk0N2RkNyIsInR5cCI6IkJlYXJlciIsImF6cCI6IlRlYW13b3JrMzY1X05ldSIsInNlc3Npb25fc3RhdGUiOiI2ZWRkY2Q0Yi01NDVjLTQwZWQtOGJjMi0wNjdlYTFmZGQ5MGQiLCJhY3IiOiIxIiwiYWxsb3dlZC1vcmlnaW5zIjpbIioiXSwicmVzb3VyY2VfYWNjZXNzIjp7IlRlYW13b3JrMzY1X05ldSI6eyJyb2xlcyI6WyJUZWFtd29yazM2NV9DUk1fUmVhZCIsIlRlYW13b3JrMzY1X0NSTV9SZWFkV3JpdGUiXX19LCJzY29wZSI6Im9wZW5pZCBlbWFpbCBwcm9maWxlIiwic2lkIjoiNmVkZGNkNGItNTQ1Yy00MGVkLThiYzItMDY3ZWExZmRkOTBkIiwiVGVhbXdvcmszNjVfUm9sZXMiOlsiVGVhbXdvcmszNjVfQ1JNX1JlYWQiLCJUZWFtd29yazM2NV9DUk1fUmVhZFdyaXRlIl0sImVtYWlsX3ZlcmlmaWVkIjp0cnVlLCJuYW1lIjoiSnVsaWFuIEhpdGwiLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiJqdWxpYW4uaGl0bEBuZXVtZWllci1lZHYuZGUiLCJnaXZlbl9uYW1lIjoiSnVsaWFuIiwiZmFtaWx5X25hbWUiOiJIaXRsIiwiZW1haWwiOiJqdWxpYW4uaGl0bEBuZXVtZWllci1lZHYuZGUifQ.KHthMRrSX7Ixg5jUAYcUVDjbIGZEkz305V6Kmo21IMMi2Iel57htSfP15Hop4Tbu0AIPCcukUfSwxyIjcXvfTaHA6sVH8SVTyxuaG_z2EW76xzn0HQYBpnpxnoZR6Fh5f2YgkRieX1WvM3NmXVnxttsqQmEjH-JMnM9i0g-1kdXkaE5BjXRddzbC2l24PVRlvnxm4dbrRlQvwQU7JBSk2W6nDBvGzFnGTvl8Y-dQOOKEzJyjA8KD96jHM6om8AblDOn8zHYTTfko9NbRKyQiXI2eIcDOupWWol_-14Eu9kmT6Bq4Dp4Ft2dv4Sc39aiylmlbJ85kvjplW5lAUubF6Q", "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICI4NTE1ZTgzOS05ZjI1LTQ3345MDUtODM5Mi1mZjExZmRjY2RmZjYifQ.eyJleHAiOjE3435MDkyOTUwOTQsImlhdCI6MTcwOTI4MDY5NCwianRpIjoiMGI4MWIxMWYtYTMzYi00YmY0LWI5ZGItZWIxMmZkOGNkOWU0IiwiaXNzIjoiaHR0cHM6Ly9pZC5uZXVtZWllci1lZHYuZGUvYXV0aC9yZWFsbXMvVGVzdCIsImF1ZCI6Imh0dHBzOi8vaWQubmV1bWVpZXItZWR2LmRlL2F1dGgvcmVhbG1zL1Rlc3QiLCJzdWIiOiI4ZTE2ZTRiNS02YTZhLTQ0YzktYWFjNC1hOGE4ZDY5NDdkZDciLCJ0eXAiOiJSZWZyZXNoIiwiYXpwIjoiVGVhbXdvcmszNjVfTmV1Iiwic2Vzc2lvbl9zdGF0ZSI6IjZlZGRjZDRiLTU0NWMtNDBlZC04YmMyLTA2N2VhMWZkZDkwZCIsInNjb3BlIjoib3BlbmlkIGVtYWlsIHByb2ZpbGUiLCJzaWQiOiI2ZWRkY2Q0Yi01NDVjLTQwZWQtOGJjMi0wNjdlYTFmZGQ5MGQifQ.kBLQ-L7sKMwcFDAB--SmKwKo_nGt59zqYo_9AmuZfw4" }

Parameter:

  • access_token: Ihr JWT Bearer Token, mit dem Sie sich an der TeamWork 365 API autorisieren können

  • refresh_token: Ihr JWT Refresh Token, mit dem Sie die bestehenden Token erneuen können

Bestehenden Access Token erneuern:

Request

[POST] <TeamWork 365-Url>/login { "Username": "max.mustermann@example.org", "Password": "w64skWMX5VQUV0kgoFlUYAuFTIgKRseiA6UA1askbjr6skCZj6M_R4QbF28YbiOJx623uyBC7o", "Tokens": { "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJ6U2RMdWd4eVNyd1hiOHd6VVc0MmE3YlZXcXN123FVUJXMGZmbXdFR0hpeW123I0In0.eyJleHAiOjE3MDkyOTUwOTQsImlhdCI6MTcwOTI4MDY5NCwianRpIjoiMTY1NmQzNzMtOGU3MS00NmRkLTg4ZTktNzkyM2ZmNmM4YjAxIiwiaXNzIjoiaHR0cHM6Ly9pZC5uZXVtZWllci1lZHYuZGUvYXV0aC9yZWFsbXMvVGVzdCIsInN1YiI6IjhlMTZlNGI1LTZhNmEtNDRjOS1hYWM0LWE4YThkNjk0N2RkNyIsInR5cCI6IkJlYXJlciIsImF6cCI6IlRlYW13b3JrMzY1X05ldSIsInNlc3Npb25fc3RhdGUiOiI2ZWRkY2Q0Yi01NDVjLTQwZWQtOGJjMi0wNjdlYTFmZGQ5MGQiLCJhY3IiOiIxIiwiYWxsb3dlZC1vcmlnaW5zIjpbIioiXSwicmVzb3VyY2VfYWNjZXNzIjp7IlRlYW13b3JrMzY1X05ldSI6eyJyb2xlcyI6WyJUZWFtd29yazM2NV9DUk1fUmVhZCIsIlRlYW13b3JrMzY1X0NSTV9SZWFkV3JpdGUiXX19LCJzY29wZSI6Im9wZW5pZCBlbWFpbCBwcm9maWxlIiwic2lkIjoiNmVkZGNkNGItNTQ1Yy00MGVkLThiYzItMDY3ZWExZmRkOTBkIiwiVGVhbXdvcmszNjVfUm9sZXMiOlsiVGVhbXdvcmszNjVfQ1JNX1JlYWQiLCJUZWFtd29yazM2NV9DUk1fUmVhZFdyaXRlIl0sImVtYWlsX3ZlcmlmaWVkIjp0cnVlLCJuYW1lIjoiSnVsaWFuIEhpdGwiLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiJqdWxpYW4uaGl0bEBuZXVtZWllci1lZHYuZGUiLCJnaXZlbl9uYW1lIjoiSnVsaWFuIiwiZmFtaWx5X25hbWUiOiJIaXRsIiwiZW1haWwiOiJqdWxpYW4uaGl0bEBuZXVtZWllci1lZHYuZGUifQ.KHthMRrSX7Ixg5jUAYcUVDjbIGZEkz305V6Kmo21IMMi2Iel57htSfP15Hop4Tbu0AIPCcukUfSwxyIjcXvfTaHA6sVH8SVTyxuaG_z2EW76xzn0HQYBpnpxnoZR6Fh5f2YgkRieX1WvM3NmXVnxttsqQmEjH-JMnM9i0g-1kdXkaE5BjXRddzbC2l24PVRlvnxm4dbrRlQvwQU7JBSk2W6nDBvGzFnGTvl8Y-dQOOKEzJyjA8KD96jHM6om8AblDOn8zHYTTfko9NbRKyQiXI2eIcDOupWWol_-14Eu9kmT6Bq4Dp4Ft2dv4Sc39aiylmlbJ85kvjplW5lAUubF6Q", "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICI4NTE1ZTgzOS05ZjI1LTQ3345MDUtODM5Mi1mZjExZmRjY2RmZjYifQ.eyJleHAiOjE3435MDkyOTUwOTQsImlhdCI6MTcwOTI4MDY5NCwianRpIjoiMGI4MWIxMWYtYTMzYi00YmY0LWI5ZGItZWIxMmZkOGNkOWU0IiwiaXNzIjoiaHR0cHM6Ly9pZC5uZXVtZWllci1lZHYuZGUvYXV0aC9yZWFsbXMvVGVzdCIsImF1ZCI6Imh0dHBzOi8vaWQubmV1bWVpZXItZWR2LmRlL2F1dGgvcmVhbG1zL1Rlc3QiLCJzdWIiOiI4ZTE2ZTRiNS02YTZhLTQ0YzktYWFjNC1hOGE4ZDY5NDdkZDciLCJ0eXAiOiJSZWZyZXNoIiwiYXpwIjoiVGVhbXdvcmszNjVfTmV1Iiwic2Vzc2lvbl9zdGF0ZSI6IjZlZGRjZDRiLTU0NWMtNDBlZC04YmMyLTA2N2VhMWZkZDkwZCIsInNjb3BlIjoib3BlbmlkIGVtYWlsIHByb2ZpbGUiLCJzaWQiOiI2ZWRkY2Q0Yi01NDVjLTQwZWQtOGJjMi0wNjdlYTFmZGQ5MGQifQ.kBLQ-L7sKMwcFDAB--SmKwKo_nGt59zqYo_9AmuZfw4" } }

Parameter:

  • Username: Ihre E-Mail Adresse, mit der Sie sich auch via Microsoft Identifizieren

  • Password: Ihr API-Token, den Sie sich in TeamWork 365 generiert haben

  • Tokens:

    • access_token: Ihr JWT Bearer Token, mit dem Sie sich an der TeamWork 365-API autorisieren können

    • refresh_token: Ihr JWT Refresh Token, mit dem Sie die bestehenden Token erneuen können

Response

{ "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJ6U2RMdWd4eVNyd1hiOHd6VVc0MmE3YlZXcXN123FVUJXMGZmbXdFR0hpeW123I0In0.eyJleHAiOjE3MDkyOTUwOTQsImlhdCI6MTcwOTI4MDY5NCwianRpIjoiMTY1NmQzNzMtOGU3MS00NmRkLTg4ZTktNzkyM2ZmNmM4YjAxIiwiaXNzIjoiaHR0cHM6Ly9pZC5uZXVtZWllci1lZHYuZGUvYXV0aC9yZWFsbXMvVGVzdCIsInN1YiI6IjhlMTZlNGI1LTZhNmEtNDRjOS1hYWM0LWE4YThkNjk0N2RkNyIsInR5cCI6IkJlYXJlciIsImF6cCI6IlRlYW13b3JrMzY1X05ldSIsInNlc3Npb25fc3RhdGUiOiI2ZWRkY2Q0Yi01NDVjLTQwZWQtOGJjMi0wNjdlYTFmZGQ5MGQiLCJhY3IiOiIxIiwiYWxsb3dlZC1vcmlnaW5zIjpbIioiXSwicmVzb3VyY2VfYWNjZXNzIjp7IlRlYW13b3JrMzY1X05ldSI6eyJyb2xlcyI6WyJUZWFtd29yazM2NV9DUk1fUmVhZCIsIlRlYW13b3JrMzY1X0NSTV9SZWFkV3JpdGUiXX19LCJzY29wZSI6Im9wZW5pZCBlbWFpbCBwcm9maWxlIiwic2lkIjoiNmVkZGNkNGItNTQ1Yy00MGVkLThiYzItMDY3ZWExZmRkOTBkIiwiVGVhbXdvcmszNjVfUm9sZXMiOlsiVGVhbXdvcmszNjVfQ1JNX1JlYWQiLCJUZWFtd29yazM2NV9DUk1fUmVhZFdyaXRlIl0sImVtYWlsX3ZlcmlmaWVkIjp0cnVlLCJuYW1lIjoiSnVsaWFuIEhpdGwiLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiJqdWxpYW4uaGl0bEBuZXVtZWllci1lZHYuZGUiLCJnaXZlbl9uYW1lIjoiSnVsaWFuIiwiZmFtaWx5X25hbWUiOiJIaXRsIiwiZW1haWwiOiJqdWxpYW4uaGl0bEBuZXVtZWllci1lZHYuZGUifQ.KHthMRrSX7Ixg5jUAYcUVDjbIGZEkz305V6Kmo21IMMi2Iel57htSfP15Hop4Tbu0AIPCcukUfSwxyIjcXvfTaHA6sVH8SVTyxuaG_z2EW76xzn0HQYBpnpxnoZR6Fh5f2YgkRieX1WvM3NmXVnxttsqQmEjH-JMnM9i0g-1kdXkaE5BjXRddzbC2l24PVRlvnxm4dbrRlQvwQU7JBSk2W6nDBvGzFnGTvl8Y-dQOOKEzJyjA8KD96jHM6om8AblDOn8zHYTTfko9NbRKyQiXI2eIcDOupWWol_-14Eu9kmT6Bq4Dp4Ft2dv4Sc39aiylmlbJ85kvjplW5lAUubF6Q", "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICI4NTE1ZTgzOS05ZjI1LTQ3345MDUtODM5Mi1mZjExZmRjY2RmZjYifQ.eyJleHAiOjE3435MDkyOTUwOTQsImlhdCI6MTcwOTI4MDY5NCwianRpIjoiMGI4MWIxMWYtYTMzYi00YmY0LWI5ZGItZWIxMmZkOGNkOWU0IiwiaXNzIjoiaHR0cHM6Ly9pZC5uZXVtZWllci1lZHYuZGUvYXV0aC9yZWFsbXMvVGVzdCIsImF1ZCI6Imh0dHBzOi8vaWQubmV1bWVpZXItZWR2LmRlL2F1dGgvcmVhbG1zL1Rlc3QiLCJzdWIiOiI4ZTE2ZTRiNS02YTZhLTQ0YzktYWFjNC1hOGE4ZDY5NDdkZDciLCJ0eXAiOiJSZWZyZXNoIiwiYXpwIjoiVGVhbXdvcmszNjVfTmV1Iiwic2Vzc2lvbl9zdGF0ZSI6IjZlZGRjZDRiLTU0NWMtNDBlZC04YmMyLTA2N2VhMWZkZDkwZCIsInNjb3BlIjoib3BlbmlkIGVtYWlsIHByb2ZpbGUiLCJzaWQiOiI2ZWRkY2Q0Yi01NDVjLTQwZWQtOGJjMi0wNjdlYTFmZGQ5MGQifQ.kBLQ-L7sKMwcFDAB--SmKwKo_nGt59zqYo_9AmuZfw4" }

Parameter:

  • access_token: Ihr JWT Bearer Token, mit dem Sie sich an der TeamWork 365 API autorisieren können

  • refresh_token: Ihr JWT Refresh Token, mit dem Sie die bestehenden Token erneuen können

Mit dem erhaltenen Access Token autorisieren:

 

Um sich mit einem JWT Bearer Token zu autorisieren, wird der Token als Teil des Authorization-Headers in HTTP-Anfragen mitgeschickt. Dabei beginnt der Header mit dem Begriff "Bearer", gefolgt von einem Leerzeichen und dem eigentlichen Token. Das sieht beispielsweise so aus:

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

Das Einbinden eines JWT Bearer Tokens variiert je nach Anwendung. Die genaue Vorgehensweise hängt von der spezifischen Anwendung ab und sollte in der entsprechenden Dokumentation nachgeschlagen werden.

Informationsklassifizierung: vertraulich