| POST | /share/refer-friend-link-used | A friend referral link was used | Validates the JWT token with the identity of the referring user and returns relevant information. |
|---|
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| ReferFriendToken | body | string | Yes |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| ReferringUser | form | ReferFriendUser | No | |
| State | form | ReferFriendState | No |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| FirstName | form | string | No | |
| LastName | form | string | No | |
| ProfilePhotoUrl | form | string | No |
| Available | |
| Awarded | |
| CanNotReferYourself | |
| YouWereAlreadySignedUp | |
| Expired |
To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
POST /share/refer-friend-link-used HTTP/1.1
Host: unstable-consumer-api.brovs.com
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length
{
referFriendToken: String
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length
{
referringUser:
{
firstName: String,
lastName: String,
profilePhotoUrl: String
},
state: Available
}