POST /v1/tokens
This token is required for accessing the API. it is the BEarer token
Api-Key header
Open. No token. Always send Api-Key as well.
Request body · application/json · AccessTokenRequest
| Property | Type | Required |
ClientId | string | no |
ClientSecret | string | no |
Responses
POST /v1/tokens/anonymous
Issues a short-lived token for browsing one tenant's public catalogue, without a secret.
Api-Key header
This API is multi-tenant and resolves its database from the caller's token, so even
listing auctions needed a token — and the only way to get one was a client secret. That
forced anything wanting to show a catalogue to hold a service credential, which a browser
application cannot do safely and which carries far more authority than browsing needs.
The tenant is not a secret; it selects which public catalogue you see, and you can see thesame thing by visiting the website. So this asks for the tenant alone and returns a tokenthat carries it, marked as anonymous. It reaches only actions marked[AllowPublicToken]: the catalogue, and the flows that get a visitor signed in.Everything about a member needs a member token from POST /v1/sessions.
The tenant is matched before it is used, never taken as given: againstPublicAccess:Tenants when that list is configured, otherwise against the registeredapplications. TenantService substitutes the tenant straight into a connection string, soan unchecked value would let a caller append their own connection parameters.
Request body · application/json · PublicTokenRequest
| Property | Type | Required |
clientId The tenant identifier, e.g. AE_Brights. Not a secret. | string | no |
Responses
| Status | Meaning | Body |
200 | A token, and when it expires. | — |
400 | No clientId supplied. | — |
404 | Not a tenant this API serves, or public access is switched off. | — |