Api Documentation

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:
  1. Manager creates AppCMS link, containing the replacement tag {{useridentity}}, for example https://thirdparty.com/tickets?bundeling_token={{useridentity}}
  2. Bundeling replaces {{useridentity}} in the link, with a user unique token: https://thirdparty.com/tickets?bundeling_token=AB7658CD87
  3. User clicks AppCMS link and navigates to https://thirdparty.com/tickets
  4. thirdparty.com sends a POST request containing the token, AB7658CD87, to https://api.bundeling.com/V2/user_identity
  5. Bundeling will provide user_uuid
  6. thirdparty.com sends a GET request to https://api.bundeling.com/V2/users/:user_uuid
  7. Bundeling will provide user data (including external reference)
  8. 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
Json
XML
POST https://api.bundeling.com/V2/user_identity

Parameters

Body

NameDescriptionTypeNillableRequired
tokenA time-limited verification token to be verified with the Verify methodstringfalsefalse

Example request

Headers

Content-Type:application/json
Api-Key:RAegSX8yZfEbqSPM

Body

{
    "token": "a24de5aff9a5167c7d754265e34f85fdb9b010e002e083a7858fad3440fe625c80063287ccc9479815492bf366e917c41fc5940267ebcc65859d27ec331dcdb2"
}

Example response

{
    "user_uuid": "eeb763c41c054dcc8f6d9362f24ee9b2"
}