hosting

POST `/v1/sites/{siteId}/ide-events`

Record something the customer did in the site's web editor.

احراز هویت

این نقطه پایانی عمومی است. هیچ مدرک احراز هویت و هیچ سازمانی نمی‌پذیرد — این همان چیزی است که سایت بازاریابی خودمان و موتورهای پاسخ‌دهنده هوش مصنوعی می‌خوانند.

این نقطه پایانی هیچ شناسه سازمانی را دریافت نمی‌کند. کلید شما در حال حاضر سازمان مربوطه را مشخص می‌کند و پاسخ در همان محدوده ارائه می‌شود.

امتحان کنید

هر چیزی را که داخل براکت‌های زاویه‌دار قرار دارد با مقادیر خودتان جایگزین کنید، و نگهدارنده کلید را با کلیدی از داشبورد خود جایگزین نمایید.

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>> }'

وارد شده‌اید؟ کنسول API در داشبورد شما شناسه سازمان واقعی و کلید خودتان را پر می‌کند و درخواست را روی API زنده اجرا می‌کند تا بتوانید پاسخ واقعی را ببینید. این نقطه پایانی را در کنسول API باز کنید

جزئیات

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.

پارامترها

نام	نوع	الزامی	چیست
`siteId (path)`	`Uuid`	بله	Site ID (UUIDv7).

بدنه درخواست

نام	نوع	الزامی	چیست
`event`	`string<file_saved, ai_applied, file_restored, terminal_opened>`	بله	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`	خیر	The file, relative to the site. Truncated to 512 characters.
`bytes_before`	`integer`	خیر	Size of the file before the write, so a truncation is visible in the log.
`bytes_after`	`integer`	خیر	—
`version`	`string`	خیر	Which kept version was restored, for a `file_restored` event.

پاسخ

نام	نوع	الزامی	چیست
`recorded`	`boolean`	بله	—

خطاهایی که این نقطه پایانی می‌تواند برگرداند

404 · 422

POST /v1/sites/{siteId}/ide-events