Keys and plans

Every /v2 endpoint that returns a measurement needs a key:

Authorization: Bearer dbk_…

A key is issued at studio.debyko.com/account. The Free plan is issued without a card; paid plans start with a seven-day trial. One key covers Studio, the API and Agent — whatever a plan includes in Studio, it includes here.

Never in a URL. A key in a query string is written into server logs, proxy logs and browser history. A request that carries one is refused with KEY_IN_URL and the key should be replaced from your account.

What a plan changes

A plan narrows what a key sees, and the answer says so rather than quietly shrinking:

• venues and instruments: a plan that includes two venues sees two venues in the registry it is answered from, and a where that names another matches nothing;
• history: asking further back than a plan reaches is refused with PLAN_LIMIT, naming the date the plan reaches and what it would take to go further — never a shortened answer that looks whole;
• rate: requests per second and per day, and the number of live streams, are counted per key. Exceeding one is a 429 with Retry-After and the name of the limit that stopped you.

Usage is counted per key, per hour and per endpoint class, and is visible in your account. No per-request log of what you asked is kept.