agency-board
POST /v1/agency/boards/{boardId}/inbound-endpoints/{endpointId}/rotate
Mint a new secret for an inbound endpoint.
Doğrulama
API açarını bearer token kimi göndərin. Bu səhifə spresifikasiyada xüsusi icazə tələb etmir, buna görə də açarınıza ehtiyac duyduğu minimum səviyyədə icazə verin və güman etmək əvəzinə cavabı yoxlayın.
Bu endpoint heç bir təşkilat ID-si tələb etmir. Sizin açarınız artıq aid olduğu təşkilatı müəyyən edir və cavab həmin təşkilat üçün məhdudlaşdırılır.
Sınaqdan keçir
Bucaqlı mötərizələrdə olan hór şeyi öz qiymətlərinizlə, açar yertutucusunu isə idarə panelinizdən bir açarla əvəz edin.
curl -X POST https://api.zinndigital.com/v1/agency/boards/{boardId}/inbound-endpoints/{endpointId}/rotate \
-H "Authorization: Bearer zdk_live_…"Sistemə daxil olmusunuz? İdarə panelinizdəki API konsolu real təşkilatınızın identifikatorunu və öz açarınızı avtomatik doldurur, sorğunu canlı API-yə qarşı icra edir ki, siz faktiki cavabı görə biləsiniz. Bu son nöqtəni API konsolunda açın
Təfərrüatlar
The URL is unchanged — only the secret the sender signs with. That separation is why a rotation is a one-field edit in the sending system rather than a reconfigure.
Parametrlər
| Ad | Tip | Tələb olunur | Nədir |
|---|---|---|---|
boardId (path) | Uuid | Bəli | Project board ID (UUIDv7). |
endpointId (path) | Uuid | Bəli | Inbound endpoint ID (UUIDv7). |
Cavab
| Ad | Tip | Tələb olunur | Nədir |
|---|---|---|---|
id | Uuid | Bəli | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
board_id | Uuid | Bəli | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
name | string | Bəli | — |
endpoint_key | string | Bəli | The opaque path segment. Not the board id, and unchanged by a secret rotation. |
url | string | Xeyr | The full URL to paste into the sending system. |
signature_scheme | string<zinn, github> | Bəli | — |
status | BoardAutomationStatus | Bəli | `suspended` means WE paused it after repeated failure and it carries a reason the customer has not read. It is a third state rather than a reuse of `disabled`, because collapsin… |
has_secret | boolean | Bəli | — |
request_count | integer | Xeyr | — |
rejected_count | integer | Xeyr | — |
last_rejection | string | Xeyr | Why the last refused request was refused — so "my n8n node says 404" is answerable from this screen rather than from a support ticket. |
last_seen_at | string | Xeyr | — |
created_at | string | Xeyr | — |
secret | string | Bəli | Shown ONCE, here. |
Bu son nöqtənin qaytara biləcəyi xətalar
401 · 403 · 404 · 422