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_uuid. This user_uuid 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/V2/user_identity
- Bundeling will provide user_uuid
- thirdparty.com sends a GET request to https://api.bundeling.com/V2/users/:user_uuid
- Bundeling will provide user data (including external reference)
- thirdparty.com checks external reference and creates a logged in session for the user
Create a time-limited verification token to be verified with the Verify method
Verify a user identity token.