Developers

Every detection, as an event your systems can use.

CamTak pushes signed JSON webhooks the moment an event happens and exposes events, evidence and reports through a REST API.

Webhooks

Signed, retried, in order.

  • Each delivery is signed with HMAC-SHA256 in the X-CamTak-Signature header.
  • Failed deliveries retry with exponential backoff for 24 hours.
  • Every event carries a stable id, so you can safely ignore duplicates.
  • Filter subscriptions by event type, site and minimum severity.

    
Event types

What you can subscribe to.

TypeSent whenDefault severity
zone.intrusionPerson in a restricted zone during its armed schedulecritical / high
loiteringPerson stayed in a zone past the dwell limithigh
crowd.densityPeople per m² above the zone thresholdcritical
person.fallA person fell and did not get upcritical
ppe.missingRequired PPE missing in a PPE zonehigh
fire.smokeSmoke or flame detectedcritical
safety.near_missPedestrian and vehicle closer than the safe distancecritical
vehicle.dwellVehicle stayed longer than allowedmedium
vehicle.driveoffVehicle left without a matching payment eventmedium
queue.lengthQueue longer than the limit for longer than the limitmedium
access.tailgatingMore people passed than badges swipedmedium
camera.offlineCamera offline, covered or movedhigh
event.acknowledgedSomeone acknowledged or dismissed an event—
report.dailyDaily report is ready, with a link—
REST API

Read events, fetch evidence, push context in.

Base URL api.taknikisi.com. Authenticate with a bearer key created in the console. Keys can be scoped to read-only or to selected sites.

MethodEndpointDescription
GET/v1/eventsList events. Filter by site, camera, type, severity and time.
GET/v1/events/{id}Fetch one event with its metrics.
GET/v1/events/{id}/evidenceSigned, expiring links to the clip and snapshots.
POST/v1/events/{id}/ackAcknowledge or dismiss an event, with a note.
GET/v1/sitesSites in your account.
GET/v1/camerasCameras with status and health.
GET/v1/reports/dailyDaily report data as JSON or CSV.
POST/v1/webhooksSubscribe an endpoint to event types.
POST/v1/ingest/{source}Send outside events in, such as POS payments or badge swipes.
Common integrations

What teams build with it.

ERP incidents

Raise an incident with the clip link whenever a safety event fires.

Access control

Send badge swipes in and get tailgating events matched to each door.

POS matching

Pair fuelling or billing events with payments to flag drive-offs.

Ticketing and chat

Open a ticket or post to your team channel for each high-severity event.

BI dashboards

Pull daily report data into your own dashboards and spreadsheets.

Guard dispatch

Page the nearest guard with the camera location and snapshot.

Need an API key?

API access and webhooks are part of the Growth and Enterprise plans. Talk to us to get a sandbox key.

Book a live demo See pricing sales@taknikisi.com