General Information
...
| Service | API | Method |
|---|
| urac | /join | POST |
Data Models: Users, Tokens
Workflow: %Link to Architecture Page% Join Flow
Input
...
Type: application/json
| Name | Source | Mandatory | Type | Special Format | Description |
|---|
| username | Body | YES | String | alphanumeric with _ , - characters only |
| |
|
| firstName | Body | YES | String | N/A |
N/A | |
Email Address Format (JSON Schema Validation) |
|
Output
...
Valid Response
| Code Block |
|---|
| language | js |
|---|
| title | Valid Response Sample |
|---|
|
{
"result": true,
"data": "..."{}
} |
...
Invalid Response
| Code Block |
|---|
| language | js |
|---|
| title | Error Response Sample |
|---|
|
{
"result":false,
"errors":{
"codes":[402],
"details":[
{
"code":402,
"message":"User account already exists."
}
]
}
} |
Error Codes
| |
|---|
| 402 | User account already exists. |
403 Error
Example (CURL)
...
Request
| Code Block |
|---|
| language | bash |
|---|
| title | Calling 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' |
...
| Code Block |
|---|
| language | js |
|---|
| title | Join API response |
|---|
|
{
"result": true,
"data": {
"id": "57c6eb28962f94a7caab8a23",
"token": "819b0aed-edd8-47d5-ada0-9e5f93cb8248"
}
} |