Authentication Overview
The Vivreal API uses API key authentication. This is the only API you need to integrate with as a developer.
How It Works
Your Website / App
│
└── Vivreal API ────── API Key (Authorization header)
- Get your API key from the Vivreal portal under Group Settings
- Pass it in the
Authorizationheader on every request - The API returns your group's published content
const res = await fetch(
"https://client.vivreal.io/tenant/collectionObjects?collectionId=abc123",
{ headers: { Authorization: process.env.VIVREAL_API_KEY } }
);
const { data } = await res.json();
Server-side only
Always call the Vivreal API from your server or serverless functions. Never expose your API key in client-side JavaScript.
API Key Properties
| Property | Detail |
|---|---|
| Scope | Read-only access to your group's published content |
| Issued to | One key per group |
| Expires | No — valid until rotated |
| Header | Authorization: <your-api-key> |
| Obtained via | Group Settings in the Vivreal portal |
Next Steps
- API Keys — Detailed guide on generating and managing API keys
- API Reference — Full endpoint documentation