Pages · Authentication

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 prefixModeStatus
tb_test_testOpen to invited partners. Orders are never made or shipped; cards are Stripe test cards.
tb_live_liveRefused 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.

ScopeAllows
orders:readList and read orders.
orders:writeQuotes, orders, revisions and cancellations.
uploads:writeStart, finalize and check uploads.
events:readRead event history.
webhooks:manageWebhook endpoints and deliveries.
billing:readRead the card on file.
billing:writeStart a card setup.

Errors

  • 401 missing_api_key: no Authorization: Bearer header.
  • 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.