tactility 0.1.0

Private request analytics API.

AUTHENTICATION

All POST actions require: Authorization: Bearer <key>

REQUEST FORMAT

{"id":"optional","params":{...}}

ACCOUNT ACTIONS

POST /v1/account/create  email, domains[]
POST /v1/account/update  account_id, email and/or domains[]
POST /v1/account/delete  account_id
POST /v1/account/get     account_id and/or email
POST /v1/account/find    optional email, domain, limit, offset

REQUEST INGESTION

POST /v1/request/create
Required: domain, ip
Optional: start, end, ms, timer, method, pathname, query,
          referrer, user_agent, status_code, request_id
start and end are Unix timestamps in milliseconds.
ms is the total duration and timer contains named durations.
Unknown fields are ignored. start defaults to ingestion time.
The IP is used for location enrichment and is never stored.
Request records expire one year after ingestion.

EXAMPLE

{
  "id": "optional",
  "params": {
    "domain": "example.com",
    "ip": "203.0.113.10",
    "start": 1787871600000,
    "end": 1787871600042,
    "ms": 42,
    "timer": {
      "database": 8.4
    },
    "method": "GET",
    "pathname": "/articles",
    "status_code": 200
  }
}

DOMAIN DATA

POST /v1/domain/get  email, domain, from, to
from and to are ISO dates. The account must include the domain.

RESPONSES

Success: {"ok":true,"data":...}
Failure: {"ok":false,"code":"...","message":"..."}

Created by Tekki AS: https://tekki.no