Authentication and environments
Bearer keys, test and live modes, and scopes.
Send your key as a Bearer token on every request to https://api.tapebloom.com/v1:
curl -sS "https://api.tapebloom.com/v1/billing" -H "Authorization: Bearer $TAPEBLOOM_API_KEY"Keep keys on your server. Cross-origin browser requests receive no CORS allowance, so a key in a web page or app would not work anyway, and would be exposed.
Test and live
The key, not the host, selects the mode. Every object carries environment, and test and live data never mix: a test order can only use test uploads, test quotes and the test card on file.
| Key prefix | Mode | Status |
|---|---|---|
tb_test_ | test | Open to invited partners. Orders are never made or shipped; cards are Stripe test cards. |
tb_live_ | live | Refused with 403 live_mode_unavailable until live payments and production are ready. |
Getting a key
Keys come by invitation. Invited partners create and revoke them in the partner portal. A key is shown once when it is created; Tapebloom stores only a fingerprint, so a lost key is revoked and replaced, not recovered.
Scopes
Each operation needs one scope, listed in the API reference. A key without it gets 403 insufficient_scope.
| Scope | Allows |
|---|---|
orders:read | List and read orders. |
orders:write | Quotes, orders, revisions and cancellations. |
uploads:write | Start, finalize and check uploads. |
events:read | Read event history. |
webhooks:manage | Webhook endpoints and deliveries. |
billing:read | Read the card on file. |
billing:write | Start a card setup. |
Errors
- 401
missing_api_key: noAuthorization: Bearerheader. - 401
invalid_api_key: the key is unknown or revoked. - 403
insufficient_scope: the key lacks the operation's scope. - 403
live_mode_unavailable: a live key, during early access.