User Register

Request

Note

The field “language” is optional.

Fields

username: The desired username of the new user (string).
email: The email of the new user (string).
password: The plain password of the new user (string).
language: The locale of the new user (string). Expected is a lowercase, two-character string in accordance with ISO 639-1:2002.

Response

Fields

token

A token to authenticate the user in future requests (string).

Keep this token. When you make future requests where the user needs to be authenticated, you supply this token with the request.

evco-id

The EVCO ID of the user (string). See also EVCO ID

HTTP Status codes

200 OK: The request was processed successfully.

Result codes

0: Success
143: Authentication failed: Email already exists

Examples

Request:

{
    "user-register": {
        "username": "user",
        "email": "[email protected]",
        "password": "plain-password",
        "language": "en"
    }
}

Response:

{
    "user": {
        "token": "e2af72d7a9084431ab0b1a5c42df7745",
        "evco-id": "DE*8PS*123456*7"
    },
    "result": {
        "code": 0,
        "message": "Success."
    }
}