Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

General Information

...

ServiceAPIMethod
urac/joinPOST


Data Model: %Link to Data Model%Models: UsersTokens

Workflow: %Link to Architecture Page% Join Flow

Input

...

Type: application/json
NameSourceMandatoryTypeSpecial FormatDescription
 
usernameBodyYESStringalphanumeric with _ , - characters only
passwordBodyYESStringN/A
firstNameBodyYESStringN/A
lastNameBodyYESStringN/A
 

...


emailBodyYESString

Email Address Format (JSON Schema Validation)



Output

...

Valid Response

Code Block
languagejs
titleValid Response Sample
{
	"result": true,
	"data": {
		"..."	
	}
}

...


Invalid Response

Code Block
languagejs
titleError Response Sample
{
    "result":false,
    "errors":{
        "codes":[400402],
        "details":[
            {
                "code":400402,
                "message":"ProblemUser withaccount the provided passwordalready exists."
            }
        ]
    }
}



Error Codes



Code
Description
402User account already exists.
400Database
Error
connection error


Example (CURL)

...

Request

Code Block
languagebash
titleCalling YOUR Join API
 > CURL -X POST http://127.0.0.1:4000/urac/...join -d 'username=john&password=johnpassword&firstName=John&lastName=Doe&email=johndoe@domain.com'

Response

Code Block
languagejs
titleYOUR Join API response
{
	"result": true,
	"data": {
		"_id": "57063608622c47b5c097d19b57c6eb28962f94a7caab8a23",
		"..."token": "819b0aed-edd8-47d5-ada0-9e5f93cb8248"
	}
}