hosting
POST /v1/sites/{siteId}/ide-events
Record something the customer did in the site's web editor.
Autenticação
Este endpoint é público. Ele não requer credenciais nem organização — é o que nosso próprio site de marketing e os mecanismos de resposta de IA leem.
Este endpoint não requer um ID de organização. Sua chave já identifica a organização à qual pertence, e a resposta é delimitada a ela.
Experimente
Substitua qualquer item entre colchetes por seus próprios valores e o espaço reservado para a chave por uma chave do seu painel.
curl -X POST https://api.zinndigital.com/v1/sites/{siteId}/ide-events \
-H "Content-Type: application/json" \
-d '{ "event": <string<file_saved, ai_applied, file_restored, terminal_opened>> }'Conectado? O console da API no seu painel preenche o ID da sua organização real e a sua própria chave, e executa a requisição contra a API de produção para que você possa ver a resposta real. Abra este endpoint no console da API
Detalhes
Appends one row to the site's activity log for an action taken in the editor — a file saved, an AI suggestion applied, an earlier version restored, a terminal opened. Editing the files of a live website is a privileged action and is logged as one. The acting person is taken from the **grant**, which the engine signed when the editor was opened, and never from the request: the caller runs inside the cage being audited, so anything it claimed about identity would be a claim by its own subject. The event name is mapped to a closed set of audit actions for the same reason. **This records what the editor did.** A customer with a terminal can change their own files without it, so it is an accountability trail for actions taken through our tool rather than a filesystem-level record. The filesystem-level answer is the site backup.
Parâmetros
| Nome | Tipo | Obrigatório | O que é |
|---|---|---|---|
siteId (path) | Uuid | Sim | Site ID (UUIDv7). |
Corpo da requisição
| Nome | Tipo | Obrigatório | O que é |
|---|---|---|---|
event | string<file_saved, ai_applied, file_restored, terminal_opened> | Sim | A closed set. The caller runs inside the cage being audited, so it names an event and the engine chooses the audit action — a log whose rows can be authored by their own subject… |
path | string | Não | The file, relative to the site. Truncated to 512 characters. |
bytes_before | integer | Não | Size of the file before the write, so a truncation is visible in the log. |
bytes_after | integer | Não | — |
version | string | Não | Which kept version was restored, for a `file_restored` event. |
Resposta
| Nome | Tipo | Obrigatório | O que é |
|---|---|---|---|
recorded | boolean | Sim | — |
Erros que este endpoint pode retornar
404 · 422