Profile 4.1

Documentation

Endpoints

*Extend the URL with /wsdl to retrieve the WSDL


Operation overview

  • getEduProfile

Operations

getEduprofile

Description

The getEduProfile operation provides information about users attached to a given redirectSessionID. The redirectSessionID is received as a GET paramenter within the Identity Callback.

The redirectSessionID is valid for single use and will expire 15 minutes after it has been received through the Identity Callback.

Authentication

Name

Type

Cardinality

Name

Type

Cardinality

authHeader

authHeader

1...1

Source

<urn:authHeader> <urn:loginHeader> <urn:username>?</urn:username> <urn:password>?</urn:password> </urn:loginHeader> </urn:authHeader>

Request

Name

Type

Cardinality

Name

Type

Cardinality

redirectSessionID

string64

1...1

Source

<urn:getEduProfileRequest> <urn:redirectSessionID>?</urn:redirectSessionID> </urn:getEduProfileRequest>

Response

Name

Type

Cardinality

Description

Name

Type

Cardinality

Description

uid

string256

1...1

 

personProfileID

string256

0...1

Present in case of a 'MBO' student

personRealID

string256

0...1

Present in case of a 'VO' student

givenName

string50

1...1

 

sn

string50

1...1

 

personTussenvoegsels

string15

0...1

 

affiliation

string50

1...1

 

digiDeliveryID

string256

0...1

 

homeOrganization

string50

1...1

 

homeOrganizationID

string4-6

1...1

 

eckID

eckID

0...1

 

Source

<urn:getEduProfileResponse> <urn:uid>?</urn:uid> <!--Optional:--> <urn:personProfileID>?</urn:personProfileID> <!--Optional:--> <urn:personRealID>?</urn:personRealID> <urn:givenName>?</urn:givenName> <urn:sn>?</urn:sn> <!--Optional:--> <urn:personTussenvoegsels>?</urn:personTussenvoegsels> <urn:affiliation>?</urn:affiliation> <!--Optional:--> <urn:digiDeliveryID>?</urn:digiDeliveryID> <urn:homeOrganization>?</urn:homeOrganization> <urn:homeOrganizationID>?</urn:homeOrganizationID> <!--Optional:--> <urn:eckID>?</urn:eckID> </urn:getEduProfileResponse>

Error codes

General errors

Error code

Description

Error code

Description

-200

Bad Request

0

General error

Something went wrong during the operation.

Specific errors

Error code

Description

Error code

Description

-1

Redirect session expired


 

Complex types

authHeader

Name

Type

Cardinality

Description

Name

Type

Cardinality

Description

loginHeader

loginHeader

1...1

 

loginHeader

Name

Type

Cardinality

Description

Name

Type

Cardinality

Description

username

string100

1...1

 

password

string64

1...1

 

 




Simple types

Name

Type

Possible values / format

Description

Name

Type

Possible values / format

Description

string4-6

String

Min length: 4 characters

Max length: 6 characters

String limited by a number of minimum and maximum allowed characters.

string15

String

Max length: 15 characters

String limited by a number of maximum allowed characters.

string50

String

Max length: 50 characters

String limited by a number of maximum allowed characters.

string64

String

Max length: 64 characters

String limited by a number of maximum allowed characters.

string100

String

Max length: 100 characters

String limited by a number of maximum allowed characters.

string256

String

Max length: 256 characters

String limited by a number of maximum allowed characters.

eckID

String

Min length: 128 characters

Max length: 256 characters

eckID is in the form of a URL: https://id.school/2015-09/[128-char hex string]. Currently this url resolves to a static page containing general information about the ECK ID.