Docs / CAMZA.AI
Make the event contract explicit.
A webhook payload needs enough context for the receiver to recognize an event and decide what to do next. This documentation provides an illustrative event shape for the website demonstration. Camza’s production API contract is not yet confirmed; field names, signing and delivery behavior must be verified before integration work.
UPDATED
Illustrative payload
{
"event_id": "sample-dock-001",
"mode": "simulation",
"occurred_at": "2026-09-16T08:30:00Z",
"camera": {
"id": "sample-07",
"label": "Loading dock"
},
"event": {
"label": "person in marked zone",
"reason": "Sample condition matched"
},
"review": {
"required": true
}
}Agree the receiver contract
| Field | Purpose | Review question |
|---|---|---|
| Event ID | Recognize the logical event | How are duplicates handled? |
| Event time | Preserve the original event time | Which timezone and clock source? |
| Camera | Identify the relevant view | Which identifiers may leave the site? |
| Reason | Give the reviewer context | Is the statement observable and useful? |
| Evidence link | Optional access to a clip | Who can open it and when does it expire? |
Minimize the transfer
Start with metadata. Add an image or clip only when the use case and access policy require it. Do not include camera credentials or destination secrets in the event body.
A few useful questions.
Can I try this on my own cameras?
Start with a compatibility request. Share camera models, firmware and the event you want to find. An evaluation needs an agreed scope before any camera access is arranged.
Is the website demonstration a product benchmark?
No. The sample demonstration uses illustrative scenes and predefined events. It does not measure accuracy, response time or compatibility on your cameras.
What should we agree before a pilot?
Agree which streams are in scope, who can access the data, where processing runs, retention and deletion, expected outcomes, and the person responsible for reviewing results.
YOUR CAMERAS. YOUR CONTEXT.
Start with one
useful question.
A camera inventory. An event to find.
A clear next step for your team.