Authentication
Create, use, store and rotate integration keys.
Every call carries a brand integration key as a bearer token:
Authorization: Bearer endvr_ik_live_...Create a key
Coming with the Client API
The Other platforms card is not in the Brand Portal yet: today Brand Settings › Integrations only offers Shopify. It ships together with the Client API.
An Owner or Admin of the brand will create keys in the Brand Portal under Brand Settings › Integrations › Other platforms, choosing the e-commerce platform. The key is shown once: copy it into your secret manager right away. ENDVR only keeps a hash and can't show it again.
A key belongs to one brand and one connection. It is meant for servers: never put it in a browser, a mobile app or a public repository.
Test and live keys
| Prefix | Mode | What it does |
|---|---|---|
endvr_ik_test_ | test | Writes test data. Test redemptions are never billed and never open an associate's next code. |
endvr_ik_live_ | live | Writes real data. Redemptions are billed according to your ENDVR plan. |
GET /connection tells you which mode a key is in. See Test mode.
Rotate a key
Create a new key in the portal and deploy it. The old key keeps working for 24 hours after the rotation, so you can switch without downtime. Revoke a key immediately if it leaks.
Errors
A missing, unknown or revoked key answers 401 with an
unauthorized problem.