Documentation

Endpoints

Environment	URL
Production	https://distributor.edu-ix.nl/soap/4.3/account
Acceptance	https://acc-distributor.edu-ix.nl/soap/4.3/account
Test	https://test-distributor.edu-ix.nl/soap/4.3/account

Authorization

The following roles have access to this web service:

Role
Distributor
ELO

Operation overview

createKey
deleteKey
getKey
login

Operations

Description

Authorization

The following roles have access to this operation:

Role
Distributor
ELO

Authentication

Name

Type

Cardinality

loginHeader

1...1

Source

Code Block
<urn:loginHeader> <!--Optional:--> <urn:username>?</urn:username> <!--Optional:--> <urn:password>?</urn:password> </urn:loginHeader>

Request

Empty request

Response

Name	Type	Cardinality
sessionID	string64	1...1

Error codes

Error code	Description
2	Authentication error

...

createKey

Description

Authorization

The following roles have access to this operation:

Role
Distributor
ELO

Authentication

Name

Cardinality

You have a CHOICE of the next 2 items at this level

Name

Type

Cardinality

loginheaderloginHeader1...1sessionIDHeadersessionIDHeader1...1

1...1

Source

Code Block

<urn:authHeader>
   <!--You have a CHOICE of the next 2 items at this level-->
   <urn:loginHeader>
      <!--Optional:-->
      <urn:username>?</urn:username>
      <!--Optional:-->
      <urn:password>?</urn:password>
   </urn:loginHeader>
   <urn:sessionIDHeader>
      <urn:sessionID>?</urn:sessionID>
   </urn:sessionIDHeader>
</urn:authHeader>

Request

Name

Type

Cardinality

profileID

1...1

userID

string256

1...1

Source

Code Block
<urn:createKeyRequest> <urn:profileID>?</urn:profileID> <urn:userID>?</urn:userID> </urn:createKeyRequest>

Response

Empty response

Error codes

Error code	Description
6	Missing required fields: userID or eckID
4426	ProfileID is already prematched
4428	Not authorized to prematch this profileID
7766	userID is already prematched

...

deleteKey

Description

Authorization

The following roles have access to this operation:

Role
Distributor
ELO

Authentication

Name

Cardinality

You have a CHOICE of the next 2 items at this level

Name

Type

Cardinality

loginheaderloginHeader1...1sessionIDHeadersessionIDHeader1...1

1...1

Source

Code Block

<urn:authHeader>
   <!--You have a CHOICE of the next 2 items at this level-->
   <urn:loginHeader>
      <!--Optional:-->
      <urn:username>?</urn:username>
      <!--Optional:-->
      <urn:password>?</urn:password>
   </urn:loginHeader>
   <urn:sessionIDHeader>
      <urn:sessionID>?</urn:sessionID>
   </urn:sessionIDHeader>
</urn:authHeader>

Request

Name

Type

Cardinality

userID

string256

1...1

Source

Code Block
<urn:deleteKeyRequest> <urn:userID>?</urn:userID> </urn:deleteKeyRequest>

Response

Empty response

Error codes

Error code	Description
6	Missing required fields: userID
7748	Not authorized to delete this prematch

...

getKey

Description

Authorization

The following roles have access to this operation:

Role
Distributor
ELO

Authentication

Name

Cardinality

You have a CHOICE of the next 2 items at this level

Name

Type

Cardinality

loginheaderloginHeader1...1sessionIDHeadersessionIDHeader1...1

1...1

Source

Code Block

<urn:authHeader>
   <!--You have a CHOICE of the next 2 items at this level-->
   <urn:loginHeader>
      <!--Optional:-->
      <urn:username>?</urn:username>
      <!--Optional:-->
      <urn:password>?</urn:password>
   </urn:loginHeader>
   <urn:sessionIDHeader>
      <urn:sessionID>?</urn:sessionID>
   </urn:sessionIDHeader>
</urn:authHeader>

Request

Name

Cardinality

You have a CHOICE of the next 3 items at this level

Name

Type

Cardinality

profileIDprofileID0...1distributorPersonIDstring2560...1userIDstring2560...1

1...1

Source

Code Block

<urn:getKeyRequest>
   <!--You have a CHOICE of the next 3 items at this level-->
   <!--Optional:-->
   <urn:profileID>?</urn:profileID>
   <!--Optional:-->
   <urn:distributorPersonID>?</urn:distributorPersonID>
   <!--Optional:-->
   <urn:userID>?</urn:userID>
</urn:getKeyRequest>

Response

Name	Type	Cardinality
key	key	0...n

Error codes

Error code	Description
6	Missing required fields: profileID, distributorPersonID or userID

...

Errors

General errors

Error code	Description
0	Unkown error
1	General error This occurs in for example: database errors or internal server errors.
2	Authentication error For instance when invalid credentials are provided.
12	Session expired The session has expired, a new session must be aquired by the login operation.

Specific errors

Specific errors are bound to the given input or request and depend on the operation you execute.

Error code	Description
0006	Missing required fields
4426	ProfileID is already prematched
4428	Not authorized to prematch this profileID
5287	Portal not found with realm from userID
7747	Prematch with this userID does not exist
7748	Not authorized to delete this prematch
7766	UserID is already prematched

...

Complex types

loginHeader

Name

Type

Cardinality

Description

username

string100

0...1

password

string64

0...1

Source

Code Block

<xs:complexType name="loginHeader">
    <xs:sequence>
        <xs:element name="username" type="types:string100" minOccurs="0" maxOccurs="1"/>
        <xs:element name="password" type="types:string64" minOccurs="0" maxOccurs="1"/>
    </xs:sequence>
</xs:complexType>

sessionIDHeader

Name

Type

Cardinality

Description

sessionID

string64

1...1

Unique token which can be acquired by executing the login operation.

Source

Code Block
<xs:sequence> <xs:element name="sessionID" type="types:string64" minOccurs="1" maxOccurs="1"/> </xs:sequence>

key

Name

Type

Cardinality

Description

profileID

1...1

Unique identifier generated by Edu-iX.

distributorPersonID

string256

0...1

Unique identifier of the person provided by the Distributor.

userID

string256

0...1

Unique identifier of the person provided by the ELO.

Source

Code Block

<xs:sequence>
    <xs:element name="profileID" type="types:profileID" minOccurs="1" maxOccurs="1"/>
    <xs:element name="distributorPersonID" type="types:string256" minOccurs="0" maxOccurs="1"/>
    <xs:element name="userID" type="types:string256" minOccurs="0" maxOccurs="1"/>
 </xs:sequence>

...

Simple types

Name	Type	Possible values / format	Description
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.
profileID	Integer		A profile ID is an positive integer number with maximum 10 characters.

...

Page Comparison

Versions Compared

Old Version 8

New Version 9

Key

Documentation

Endpoints

Authorization

Operation overview

Operations

login

Description

Authorization

Authentication

Request

Response

Error codes

createKey

Description

Authorization

Authentication

Request

Response

Error codes

deleteKey

Description

Authorization

Authentication

Request

Response

Error codes

getKey

Description

Authorization

Authentication

Request

Response

Error codes

Errors

General errors

Specific errors

Complex types

loginHeader

sessionIDHeader

key

Simple types