Authenticate API requests

Pass your API key in the Authorization header on every request. Bearer-style is the only supported format.

GET /api/v1/stores HTTP/1.1
Host: maptera.switchlabs.dev
Authorization: Bearer YOUR_API_KEY

cURL example

curl https://maptera.switchlabs.dev/api/v1/stores \
  -H "Authorization: Bearer YOUR_API_KEY"

JavaScript (fetch)

const res = await fetch("https://maptera.switchlabs.dev/api/v1/stores", {
  headers: {
    "Authorization": `Bearer ${process.env.MAPTERA_API_KEY}`,
  },
});
const stores = await res.json();

Common 401 causes

• Missing the "Bearer " prefix in the header
• Using a revoked key
• Including the key in the URL instead of the header (not supported)
• Trailing whitespace or newlines in the key