Get Tile Token

GET

/tiles/token/{dataset_id}/

const url = 'https://example.com/tiles/token/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://example.com/tiles/token/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/

Generate a tile token for a dataset.

For vector datasets: returns HMAC-signed token (sig, exp, scope, expires_in). For raster datasets: returns tile URL template and metadata.

Both responses include a discriminated kind field.

Public datasets can be accessed without authentication. Private/restricted datasets require authentication and RBAC checks.

Authorizations

Parameters

Path Parameters

dataset_id

required

Dataset Id

string format: uuid

Responses

200

Successful Response

application/json

Any of:

VectorTileToken
RasterTileToken

VectorTileToken

object

exp

required

Exp

integer

expires_in

required

Expires In

integer

kind

required

Kind

string

Allowed value: vector

scope

required

Scope

string

sig

required

Sig

string

Example

{
  "kind": "vector"
}

400

Bad request — invalid query parameters or payload

application/problem+json

ProblemDetail

object

detail

required

Any of:

string

status

required

Status

integer

title

required

Title

string

type

Type

string

default: about:blank

Example

{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

404

Not found

application/problem+json

ProblemDetail

object

detail

required

Any of:

string

status

required

Status

integer

title

required

Title

string

type

Type

string

default: about:blank

Example

{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

422

Validation error

application/problem+json

ProblemDetail

object

detail

required

Any of:

string

status

required

Status

integer

title

required

Title

string

type

Type

string

default: about:blank

Example

{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

500

Internal server error

application/problem+json

ProblemDetail

object

detail

required

Any of:

string

status

required

Status

integer

title

required

Title

string

type

Type

string

default: about:blank

Example

{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

503

Service unavailable — the database could not serve the request

application/problem+json

ProblemDetail

object

detail

required

Any of:

string

status

required

Status

integer

title

required

Title

string

type

Type

string

default: about:blank

Example

{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}