ConsumerApi

<back to all web services

ReferBusinessLinkUsedRequest

ConsumerBusiness
The following routes are available for this service:
POST/share/refer-business-link-usedA business referral link was usedValidates the JWT token with the identity of the referring user and the place, and returns relevant information.
ReferBusinessLinkUsedRequest Parameters:
NameParameterData TypeRequiredDescription
ReferBusinessTokenbodystringYes
ReferBusinessLinkUsedResponse Parameters:
NameParameterData TypeRequiredDescription
ReferringUserformReferBusinessUserNo
ReferredPlaceformReferredPlaceNo
ExpiresAtformDateTimeOffset?No
StateformReferBusinessStateNo
ReferBusinessUser Parameters:
NameParameterData TypeRequiredDescription
FirstNameformstringYes
LastNameformstringYes
ProfilePhotoUrlformstringNo
ReferredPlace Parameters:
NameParameterData TypeRequiredDescription
IdformlongNo
GuidformGuidNo
NameformstringYes
LogoUrlformstringNo
ImageUrlformstringNo
ReferBusinessState Enum:
SignInToSee
Available
CanNotReferYourself
AlreadyClaimedByYou
AlreadyClaimedBySomeoneElse
Expired

To override the Content-type in your clients, use the HTTP Accept Header, append the .other suffix or ?format=other

HTTP + OTHER

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /share/refer-business-link-used HTTP/1.1 
Host: consumer-api.brovs.com 
Accept: text/jsonl
Content-Type: text/jsonl
Content-Length: length

{"referBusinessToken":"String"}
HTTP/1.1 200 OK
Content-Type: text/jsonl
Content-Length: length

{"referringUser":{"firstName":"String","lastName":"String","profilePhotoUrl":"String"},"referredPlace":{"id":0,"name":"String","logoUrl":"String","imageUrl":"String"},"expiresAt":"0001-01-01T00:00:00.0000000+00:00","state":"SignInToSee"}