身份驗證

Create a key

Create and manage API keys in the dashboard under Settings → Developers. The full key is shown only once, at creation — store it somewhere safe. Keys are prefixed with mapleads_.

Send the key

Pass it as a bearer token on every request:

Authorization: Bearer mapleads_xxx

Or, equivalently, in an x-api-key header:

x-api-key: mapleads_xxx

Scopes

A key can be restricted to a set of scopes; a scoped key may only perform those actions (omit scopes to leave it unrestricted). A request missing a required scope returns 403 insufficient_scope.