Linchpin User Profiles - Documentation

Create a meaningful and up to date profile

See the documentation for your Release

REST APIs

The Custom User Profile has a RESTful API to retrieve useful information for any kind of external usage. All endpoints return their data as JSON strings (a standardized lightweight data-interchange format).
Do you miss some features here? Please feel free to let us know.

Profile Fields API

The Profile Fields API gives you all informations  about the configured fields. The Profile Fields API is available under YOUR_DOMAIN_AND_CONTEXT/rest/cup/1.0/fields.

Retrieve a list of all configured user profile fields.

  • URL: /rest/cup/1.0/fields
  • Method: GET

Results in a complete list of configured fields:

DOMAIN_AND_CONTEXT/rest/cup/1.0/fields
[
   {
      "userFieldPK":5,
      "userFieldBK":"cup.fachbereich-5",
      "labelPropertyKey":"Abteilung",
      "ldapKey":"ou",
      "position":0,
      "hidden":false,
      "inVCard":false
   },
   {
      "userFieldPK":16,
      "userFieldBK":"cup.titel-16",
      "labelPropertyKey":"Titel",
      "ldapKey":"title",
      "position":0,
      "hidden":false,
      "inVCard":false
   },
   {
      "userFieldPK":8,
      "userFieldBK":"cup.vorname-8",
      "labelPropertyKey":"Name",
      "ldapKey":"cn",
      "position":1,
      "hidden":false,
      "inVCard":true
   },
   {
      "userFieldPK":13,
      "userFieldBK":"cup.abteilungsnummer-13",
      "labelPropertyKey":"Abteilungsnummer",
      "ldapKey":"departmentNumber",
      "position":1,
      "hidden":false,
      "inVCard":false
   },
   {
      "userFieldPK":6,
      "userFieldBK":"cup.ort-6",
      "labelPropertyKey":"Ort",
      "ldapKey":"l",
      "position":2,
      "hidden":false,
      "inVCard":true
   },
   {
      "userFieldPK":11,
      "userFieldBK":"cup.telefon-11",
      "labelPropertyKey":"Telefon",
      "ldapKey":"telephoneNumber",
      "position":2,
      "hidden":false,
      "inVCard":true
   },
   {
      "userFieldPK":7,
      "userFieldBK":"cup.land-7",
      "labelPropertyKey":"Land",
      "ldapKey":"st",
      "position":3,
      "hidden":false,
      "inVCard":false
   },
   {
      "userFieldPK":10,
      "userFieldBK":"cup.e-mail-10",
      "labelPropertyKey":"E-Mail",
      "ldapKey":"mail",
      "position":3,
      "hidden":false,
      "inVCard":true
   },
   {
      "userFieldPK":12,
      "userFieldBK":"cup.fachbereich-12",
      "labelPropertyKey":"Fachbereich",
      "ldapKey":"businessCategory",
      "position":4,
      "hidden":false,
      "inVCard":true
   },
   {
      "userFieldPK":15,
      "userFieldBK":"cup.sprache-15",
      "labelPropertyKey":"Sprache",
      "ldapKey":"preferredLanguage",
      "position":4,
      "hidden":false,
      "inVCard":false
   },
   {
      "userFieldPK":14,
      "userFieldBK":"cup.raumnummer-14",
      "labelPropertyKey":"Raumnummer",
      "ldapKey":"roomNumber",
      "position":5,
      "hidden":false,
      "inVCard":false
   },
   {
      "userFieldPK":17,
      "userFieldBK":"cup.stufe-17",
      "labelPropertyKey":"Stufe",
      "ldapKey":"employeeType",
      "position":6,
      "hidden":false,
      "inVCard":false
   },
   {
      "userFieldPK":18,
      "userFieldBK":"cup.jourfix-18",
      "labelPropertyKey":"Jour Fix",
      "ldapKey":"",
      "position":10,
      "hidden":true,
      "inVCard":false
   },
   {
      "userFieldPK":19,
      "userFieldBK":"cup.vorgesetzter-19",
      "labelPropertyKey":"Vorgesetzter",
      "ldapKey":"",
      "position":120,
      "hidden":false,
      "inVCard":false
   }
]

Get a list of all values (sorted and unique) used for one field

With this endpoint of the Profile Fields API you can get all set values for one specific field.

  • URL: /rest/cup/1.0/fields/{fieldKey}
  • Parameters: 
    • fieldKey: field key ("userFieldBK") configured in CUP
  • Method: GET

Results in a list of all given user values:

DOMAIN_AND_CONTEXT/rest/cup/1.0/fields/cup.fachbereich-5
 ["Catering","Consulting","Executive","Legals","Sales","Services","Systems","Technologies"]

User Profile API

The User Profile API provides various profile information. The API is available under DOMAIN_AND_CONTEXT/rest/cup/1.0/profile.

Get the CUP profile of the current user

With this endpoint of the User Profile API you can get the complete profile data of the currently logged in user.

  • URL: DOMAIN_AND_CONTEXT/rest/cup/1.0/profile
  • Method: GET 

Results in a complete set of profile information:

DOMAIN_AND_CONTEXT/rest/cup/1.0/profile
{
   "cup.abteilungsnummer-13":"712",
   "cup.e-mail-10":"Buckminster.Powell@Sales.company.com",
   "cup.fachbereich-12":"Accounting",
   "cup.fachbereich-5":"Sales",
   "cup.jourfix-18":null,
   "cup.land-7":"Germany",
   "cup.ort-6":"Kassel",
   "cup.raumnummer-14":"5925",
   "cup.sprache-15":"DE",
   "cup.stufe-17":"Staff",
   "cup.telefon-11":"(003) 28547554",
   "cup.titel-16":"0",
   "cup.vorgesetzter-19":null,
   "cup.vorname-8":"Buckminster Powell"
}

Get the CUP profile of a given user

With this endpoint of the User Profile API you can get the complete profile data of any given user.

  • URL: DOMAIN_AND_CONTEXT/rest/cup/1.0/profile/{userName}
  • Parameters:
    • userName: confluence user name for the profile you want to retrieve 
  • Method: GET

Results in a complete set of visible profile information of a specified user:

DOMAIN_AND_CONTEXT/rest/cup/1.0/profile/user
{
   "cup.abteilungsnummer-13":"580",
   "cup.e-mail-10":"Bianca.Villarreal@Executive.company.com",
   "cup.fachbereich-12":"Advertising",
   "cup.fachbereich-5":"Executive",
   "cup.jourfix-18":null,
   "cup.land-7":"Norway",
   "cup.ort-6":"Oslo",
   "cup.raumnummer-14":"2843",
   "cup.sprache-15":"EN",
   "cup.stufe-17":"Executive",
   "cup.telefon-11":"(08122) 5570356",
   "cup.titel-16":"0",
   "cup.vorgesetzter-19":null,
   "cup.vorname-8":"Bianca Villarreal"
}
  • No labels

This content was last updated on 07/27/2016.

This content hasn't been updated in a while. That doesn't have to be a problem. Some of our pages live for years without becoming obsolete.

Old content can be incorrect, misleading or outdated. Please get in contact with us via a form on this page, our live chat or via email with content@seibert.group if you are in doubt, have a question, suggestion, or want changes from us.