Keytiles APIs
@Keytiles we follow "API first" approach. This means all the GUIs we provide are also using exactly the same endpoints we document here to handle data collection, data query (and visualization) and User / Container management.
We document our contracts in OpenApi 3.x format which you can find in our Github area in this repository: https://github.com/keytiles/keytiles-public-api
All our APIs are following semantic versioning - which helps you to feel how big the difference is between different versions.
- # Client side APIs
- # Tracking Script API
- # Backend APIs
- # Hit Collection API
- # v1.5 - current
- # Older deprecated versions
- # Query API
- # v2.3 - current
- # Older deprecated versions
- # v1.0 - current (partially)
- # Management API
- # v1.3 - current
- # Older deprecated versions
Client side APIs
Tracking Script API
If you install our Tracking Script into your website then from JavaScript you can use it's API to achieve different things programmatically if you need to.
You can find the reference of our Tracking Script API here!
Backend APIs
Hit Collection API
The Hit Collection API is providing the possibility to send in events into Keytiles and let the system process them.
This is an RPC style API so simply a collection of methods to pick up data.
For website owners / developers we provide a drop-in Javascript - called the Tracking Script - which you can easily include into your web page and it will use this Hit Collection API in the background to send in data. See Getting started with Keytiles for more details!
Versions:
v1.5 - current
Older deprecated versions
Kept for diff purposes only.
- v1.4 - view on Swagger UI
- v1.4 - schema file in Git repo
- v1.3 - view on Swagger UI
- v1.3 - schema file in Git repo
- v1.2 - view on Swagger UI
- v1.2 - schema file in Git repo
- v1.1 - view on Swagger UI
- v1.1 - schema file in Git repo
- v1.0 - view on Swagger UI
- v1.0 - schema file in Git repo
Query API
The Query API provides a set of GET endpoints to query statistics data stored by Keytiles service.
Versions:
v2.3 - current
Not everything is migrated from v1.0 into this new version yet so v1.0 is still valid.
Explanation article: QueryAPI v2 - Webhits Event counter queries
Older deprecated versions
Kept for diff purposes only.
- v2.2 - view on Swagger UI
- v2.2 - schema file in Git repo
- v2.1 - view on Swagger UI
- v2.1 - schema file in Git repo
- v2.0 - view on Swagger UI
- v2.0 - schema file in Git repo
v1.0 - current (partially)
But a few endpoints in it are already deprecated!
We are moving the endpoints from this version into v2.x step by step - until not complete we can not deprecate this version!
Management API
API to manage Users, Containers and permissions.
This is mostly RESTful API but we also have some RPC style endpoints in it.
Versions:
v1.3 - current
Older deprecated versions
Kept for diff purposes only.