User identity
With this endpoint you can verify a user if they select an AppCMS page that links to an external website. Managers can add {{useridentity}} to a link. Bundeling will replace {{useridentity}} with a token that is unique per user as GET parameter. This token is a onetime token that can be verified using this endpoint. On condition that the token is valid, this endpoint will tell you who this users is by providing a user_id. This user_id can then be used in the “Users” endpoint to get all the information including the “External reference field” in which you can store your external ID.
Flow:
- Manager creates AppCMS link, containing the replacement tag {{useridentity}}, for example https://thirdparty.com/tickets?bundeling_token={{useridentity}}
- Bundeling replaces {{useridentity}} in the link, with a user unique token: https://thirdparty.com/tickets?bundeling_token=AB7658CD87
- User clicks AppCMS link and navigates to https://thirdparty.com/tickets
- thirdparty.com sends a POST request containing the token, AB7658CD87, to https://api.bundeling.com/V1/user_identity
- Bundeling will provide user_id
- thirdparty.com sends a GET request to https://api.bundeling.com/V1/users/:user_id
- Bundeling will provide user data (including external reference)
- thirdparty.com checks external reference and creates a logged in session for the user
Verify a user identity token.