Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »

Documentation

Endpoints

Environment

URL

Production


Acceptance


Test


Downloads

  • WSDL

  • XSD

Authorization

The following roles have access to this web service:

Role

Distributor

ELO

Operation overview

  • createKey

  • deleteKey

  • getKey

  • login

Operations

login

Description

Authorization

The following roles have access to this operation:

Role

Distributor

ELO

Authentication

Name

Type

Cardinality

loginHeader

loginHeader

1...1

Source

 <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

NameTypeCardinalityloginheaderloginHeader1...1sessionIDHeadersessionIDHeader

1...1

Source

 <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

profileID

1...1

userID

string256

1...1

Source

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

Response

Empty response

Error codes

T.b.d.


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

NameTypeCardinalityloginheaderloginHeader1...1sessionIDHeadersessionIDHeader

1...1

Source

 <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

NameTypeCardinalityprofileIDprofileID0...1distributorPersonIDstring2560...1userIDstring2560...1


1...1

Source

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

Response

Empty response

Error codes

T.b.d.


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

NameTypeCardinalityloginheaderloginHeader1...1sessionIDHeadersessionIDHeader1...1


1...1

Source

 <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

profileID


Source

 <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

T.b.d.


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.

3

Login sessionID is expired

The given sessionID is no longer active and has expired. Acquire a new sessionID to proceed.

4

Authorization error

You do not have permission to use this operation.

5

Bad request

Parsing error, for instance when invalid xml has been provided.

Specific errors

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

Error code

Description

-

T.b.d.


Complex types

loginHeader

Name

Type

Cardinality

Description

username

string100

0...1


password

string64

0...1


Source

 <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

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

key

Name

Type

Cardinality

Description

profileID

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

<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.



  • No labels