Overview
The shortest path to understanding the provider integration model
Overview
VRPlatform exposes one primary provider API and one optional ingest surface.
| Surface | Host | Purpose |
|---|---|---|
| Product API | api.edge.vrplatform.app | team setup, app discovery, connection management, iframe session issuance, iframe product traffic |
| Raw ingest | ingest.edge.vrplatform.app | direct data submission under a separate M2M contract |
Standard Provider Flow
Most providers only need these steps:
- get a provider API key
- list or create the managed team
- create the connection for that team
- if you embed VRPlatform, issue a session for each iframe user
Credentials
The external model is simple:
- backend integration calls use a provider API key in
x-api-key - iframe product calls use a short-lived VRPlatform bearer token
- raw ingest, if enabled, uses an M2M token
Team Context
Provider routes come in two shapes:
- provider-scoped routes, such as
GET /teamsorGET /apps - team-scoped routes, such as
POST /connections
For team-scoped product routes, send:
x-team-id: <managed-team-id>