Profile API

4 minutes to read Download PDF Edit

Introduction

The Profile API is an App Service that allows your AppCloud applications to retrieve profile information of their users from the Mendix platform.

The service is part of the AppCloudServices module, which is available from the App Store. It is also included in the default themes when creating a new application. Both of these options include a default implementation of the Profile API.

API Calls

GetUserProfile

Description

Retrieves profile information for a user of the application based on the user’s OpenID. Note that you can only retrieve the profile information of users who have access to your application.

Available in

API Version 3

Parameters

Name Parameter type Required Description
OpenID String Yes OpenID of the user for whom the profile is requested.
EnvironmentUUID String Yes UUID of the requesting environment. This should be the value of the AppCloudServices.EnvironmentUUID constant, which the Mendix Cloud Portal will fill in automatically.
EnvironmentPassword String Yes Password of the requesting environment. This should be the value of the AppCloudServices.EnvironmentUUID constant, which the Mendix Cloud Portal will fill in automatically.

Return type

ProfileService.UserProfile object

This call will return a UserProfile object representing the user’s profile information, as well as a Company object (which the UserProfile refers to) containing basic information about the user’s company.

UserProfile

Attribute Type Description
OpenId String OpenID of the user, which uniquely identifies this user within the Mendix platform
DisplayName String Name of the user
EmailAddress String Email address at which the user chose to receive communications from the Mendix platform.
AvatarUrl String Location of the user’s avatar.
AvatarThumbnailUrl String Location of a smaller (48x48) version of the user’s avatar
JobTitle String Job title of the user
Department String Department the user works in
Location String Location of the user
Country String Country of the user
Bio String Short biography of the user
Website String Website of the user
Phone String Phone number of the user
LinkedIn String Address of the user’s LinkedIn profile
Twitter String Twitter username for the user
Skype String Skype username for the user
CompanyId String ID which uniquely identifies the company the user is a member of
Company String Name of the company which the user is a member of
UserProfile_Company Reference Reference to the object representing the user’s company. (Note that the values of the CompanyId and Company attributes of the UserProfile object and the CompanyId and CompanyName attributes of the referred Company object will be identical.)

Company

Attribute Type Description
CompanyId String ID which uniquely identifies the company represented by this object
CompanyName String Name of the company

GetDisplayName

Description

Retrieves the name of a user of the application based on the user’s OpenID. Note that you can only retrieve the names of users who have access to your application.

Available in

API Version 1

Parameters

Name Parameter type Required Description
OpenID String Yes OpenID of the user for whom the name is requested.
EnvironmentUUID String Yes UUID of the requesting environment. This should be the value of the AppCloudServices.EnvironmentUUID constant, which the Mendix Cloud Portal will fill in automatically.
EnvironmentPassword String Yes Password of the requesting environment. This should be the value of the AppCloudServices.EnvironmentUUID constant, which the Mendix Cloud Portal will fill in automatically.

Return type

String

Copyright © Mendix. All rights reserved. | Mendix.com | Terms of Use | Privacy Policy