Đã xem lại 2026-11-10 · Phiên bản API 2026-11-09 · Đọc Markdown
Xác thực và khóa sản phẩm
UI, REST API và bộ chuyển đổi MCP của AiVideoEditor dùng chung các dịch vụ không gian làm việc.
Máy khách API dùng khóa sản phẩm, không phải token OAuth của mạng xã hội hay thông tin xác
thực cơ sở dữ liệu. Tạo khóa tại /app/developers sau khi đăng nhập vào đúng không gian làm việc.
Sao chép khóa dạng văn bản thuần pk_v1_… một lần và lưu nó vào trình quản lý bí mật
hoặc môi trường cục bộ được bảo vệ. AiVideoEditor giữ lại một băm và tiền tố hiển thị.
Gửi khóa
curl --fail-with-body -sS \
-H "Authorization: Bearer $PUBLISHER_KEY" \
"$PUBLISHER_API_URL/api/v1/usage"
Dùng HTTPS cho một origin đã triển khai. Giữ thông tin xác thực xa khỏi URL, quản lý mã nguồn, các prompt trò chuyện, ảnh chụp màn hình và nhật ký. Tải lên lưu trữ trực tiếp dùng URL đã ký và header được trả về; không chuyển tiếp bearer key của AiVideoEditor đến nơi lưu trữ.
Phạm vi và quyền truy cập tài khoản
| Phạm vi | Khả năng |
|---|---|
accounts:read | Kiểm tra tài khoản, khả năng và cài đặt TikTok |
media:write | Đặt chỗ, hoàn tất và quản lý các lần tải lên |
posts:read | Liệt kê bài đăng, xác thực bản nháp và quan sát trạng thái |
posts:write | Tạo và chỉnh sửa bản nháp |
posts:publish | Đăng, lên lịch, hủy và thử lại các lượt gửi |
usage:read | Đọc mức sử dụng và thông tin gói của không gian làm việc |
webhooks:manage | Đăng ký, liệt kê và xóa các endpoint webhook |
Phạm vi là tên chính xác, không phải một hệ phân cấp. Chỉ cấp những phạm vi mà tích
hợp cần. Khóa cũng có thể hạn chế các ID tài khoản có thể truy cập. Tư cách thành viên
không gian làm việc, vai trò hiệu lực, giới hạn tài khoản và trạng thái gói vẫn được áp dụng.
Một khóa có posts:publish không tự động có quyền ghi bản nháp.
Bộ phạm vi khóa mặc định bỏ qua posts:publish và webhooks:manage. Tác nhân
chỉ bản nháp có thể chuẩn bị công việc để xem xét mà không có quyền gửi nó. Khóa
không thể tạo khóa khác hoặc thay đổi thanh toán.
Thu hồi và khôi phục
Thu hồi khóa bị xâm phạm trong giao diện dành cho nhà phát triển. Xem số công việc đang chờ
của nó trước: thu hồi tạm dừng công việc chưa gửi đi với trạng thái requires_action; nó không
xóa bản nháp. Tạo khóa thay thế với quyền truy cập phù hợp và xem xét công việc đang
chờ trước khi tiếp tục. Không giả định rằng thu hồi có thể thu hồi lại một lượt gửi
đã được gửi ra bên ngoài.
401 nghĩa là thông tin xác thực vắng mặt hoặc không hợp lệ. 403 nghĩa là chủ thể
đã xác thực thiếu quyền hoặc quyền truy cập tài khoản. Việc thử lại lặp đi lặp lại
cả hai phản hồi này sẽ không khắc phục được. Xem lỗi và khôi phục.