Authentication and keys
Test and live keys, scopes, IP allowlists, allowed origins and key rotation in the OurScent API.
Every request carries your key in the Authorization header:
Authorization: Bearer os_live_…Test and live keys
| Prefix | Returns | Cost |
|---|---|---|
os_test_ | Fixed sample data | Free |
os_live_ | Real data | Spends credits |
Scopes
Each key has scopes: vision, data and images. A call outside a key’s scopes returns 403 forbidden_scope. Give each app the least it needs.
IP allowlist
Restrict a server key to IP addresses or CIDR ranges (e.g. 203.0.113.0/24). Calls from anywhere else are refused with 403.
Allowed origins (browser keys)
A key used from a web page is locked to your origins (e.g. https://shop.example.com), so it fails if copied to another site. Never put an unrestricted key in browser code.
Rotation and revocation
“Rotate” in the console creates a replacement with the same settings and revokes the old key at once. Revocation takes effect within a minute. We store only the key’s SHA-256 hash, so a lost key cannot be recovered.