Instance handshake

Handshake request from LViS to service

post
Instance handshake

https://example-service.lvis.io/lvis
Request
Response
Request
Body Parameters
id
optional
string
Unique identifier across all LViS instances, in UUID format.
name
optional
string
Human-readable LViS instance name.
auth_endpoint
optional
string
Authentication endpoint.
feed_endpoint
optional
string
Listings and elements feeds endpoint, can be used to construct feed URL.
static_host
optional
string
LViS static host, which can be used to fetch public feeds.
Response
200: OK
Response on the instance handshake request.
{
"service_id": "demographics",
"service_type": "demographics",
"analytics": true,
"listings_notifications": false,
"elements_notifications": false,
"event_feeds": [
{
"id": "results",
"name": "Segments Results"
},
{
"id": "player_stats",
"name": "Player statistics"
}
]
}

Example

cURL
Response
cURL
curl --request POST \
--url https://example-service.lvis.io/lvis \
--header 'Content-Type: application/vnd.api+json' \
--data '{
"id": "c068dd33-46c3-4789-a619-b14e4bcbe990",
"name": "Development instance",
"auth_endpoint": "https://environment.lvis.io",
"feed_endpoint": "https://environment.lvis.io",
"static_host": "d3mssdvj2sslxw.cloudfront.net"
}'
Response
{
"service_id": "demographics",
"service_type": "demographics",
"analytics": true,
"listings_notifications": false,
"elements_notifications": false,
"event_feeds": [
{
"id": "results",
"name": "Segments Results"
},
{
"id": "player_stats",
"name": "Player statistics"
}
]
}

Response parameters

service_id

3rd party service identifier.

service_type

Service type.

analytics

Optional boolean flag to enable/disable Analytics API.

listings_notifications

Flag shows whether Listings notification enabled.

elements_notifications

Flag shows whether Elements notification enabled.

event_feeds

Service feeds. Optional.