identity

PUT `/v1/me/overview-shortcuts`

Replace this person's Overview shortcut cards.

Tất cả tài liệu dành cho nhà phát triển →

Xác thực

Gửi khóa API dưới dạng mã thông báo bearer. Điểm cuối này không nêu rõ quyền cụ thể trong thông số kỹ thuật, vì vậy hãy cấp cho khóa của bạn quyền tối thiểu cần thiết và kiểm tra phản hồi thay vì phỏng đoán.

Endpoint này không nhận ID tổ chức. Khóa của bạn đã xác định tổ chức mà nó thuộc về và phản hồi được giới hạn trong phạm vi đó.

Dùng thử

Thay thế bất kỳ nội dung nào trong ngoعل (angle brackets) bằng giá trị của riêng bạn và trình giữ chỗ key bằng một key từ trang tổng quan của bạn.

curl -X PUT https://api.zinndigital.com/v1/me/overview-shortcuts \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "shortcuts": <OverviewShortcutIds> }'

Đã đăng nhập? Bảng điều khiển API trong trang quản lý của bạn sẽ tự điền ID tổ chức thực tế và khóa của riêng bạn, sau đó chạy yêu cầu đối với API trực tiếp để bạn có thể xem phản hồi thực tế. Mở điểm cuối này trong bảng điều khiển API

Chi tiết

Replaces the whole list. ⛔ PUT rather than PATCH, and the verb is load-bearing: the ORDER is the preference, so a merge semantic could not express "move the third card above the first". Idempotent by construction, so it takes no Idempotency-Key. An empty list is accepted and is a real choice — it clears the strip and stops the presets coming back. Duplicate ids are REFUSED rather than de-duplicated: two cards for one section is a client bug, and repairing it quietly would leave the customer with one fewer card than they dragged in and nothing to read about why.

Nội dung yêu cầu

Tên	Loại	Bắt buộc	Nội dung này là gì
`shortcuts`	`OverviewShortcutIds`	Có	Dashboard navigation ids, in the order the cards appear. Opaque to the engine: it bounds the count, the length and the charset and stores the rest verbatim, because the section…

Phản hồi

Tên	Loại	Bắt buộc	Nội dung này là gì
`shortcuts`	`OverviewShortcutIds`	Có	Dashboard navigation ids, in the order the cards appear. Opaque to the engine: it bounds the count, the length and the charset and stores the rest verbatim, because the section…
`chosen`	`boolean`	Có	Whether this person has ever chosen. ⛔ Not inferable from an empty list, which is why it is on the wire: `false` with an empty list means nobody has chosen and the client shows…

Các lỗi điểm cuối này có thể trả về

401 · 403 · 422 · 429

PUT /v1/me/overview-shortcuts