Access token dùng để làm gì
Access token (còn gọi là khóa API) cho phép phần mềm của bạn, một lập trình viên hoặc một công cụ bên thứ ba đọc dữ liệu từ cửa hàng qua Storeep API. Mỗi token có quyền, khoảng dữ liệu và ngày hết hạn riêng, nên bạn có thể cấp cho từng công cụ đúng những gì nó cần và thu hồi bất cứ lúc nào mà không phải chia sẻ mật khẩu.
Mở Cài đặt > Access token. Nút Xem tài liệu mở tài liệu tham khảo API, với các endpoint, cách gửi token và giới hạn yêu cầu. Hãy chia sẻ trang đó với lập trình viên của bạn.
Bạn muốn kết nối một trợ lý AI như Claude hoặc ChatGPT? Việc đó không dùng access token. Xem Kết nối trợ lý AI.
Tạo token
Nhấn Tạo token mới, điền biểu mẫu và nhấn Tạo.
- Tên token: nhãn để nhận ra token trong danh sách, ví dụ "Đồng bộ kế toán". Chỉ bạn thấy tên này.
- Quyền: đánh dấu ít nhất một quyền:
- Đọc sản phẩm: danh sách sản phẩm, chi tiết, biến thể và tồn kho.
- Đọc đơn hàng: lịch sử đơn hàng, chi tiết, trạng thái và các dòng sản phẩm.
- Đọc webhook: xem cấu hình webhook và nhật ký gửi.
- Quản lý webhook: tạo, cập nhật và xóa đăng ký webhook qua API.
- Quyền truy cập dữ liệu: token được đọc lùi về bao xa.
- 24 giờ qua: chỉ dữ liệu tạo trong 24 giờ qua. Lựa chọn an toàn nhất, phù hợp cho đồng bộ trực tiếp.
- Đặt ngày bắt đầu: chỉ dữ liệu tạo từ ngày bạn chọn trong Ngày bắt đầu truy cập dữ liệu trở đi.
- Mọi thời gian: toàn bộ dữ liệu, không giới hạn ngày.
- Thời hạn: Không bao giờ hết hạn, hoặc Đặt ngày hết hạn để chọn một ngày trong vòng tối đa một năm tới. Sau ngày đó token tự ngừng hoạt động.
Sao chép token ngay
Sau khi bạn nhấn Tạo, cửa sổ hiển thị Access token của bạn với một nút sao chép. Token này chỉ hiển thị một lần. Hãy sao chép và cất ở nơi an toàn, như trình quản lý mật khẩu. Storeep không thể hiển thị lại. Nếu làm mất, hãy xóa token và tạo token mới.
Hãy đối xử với nó như mật khẩu. Không bao giờ đặt nó trong mã website, kho mã công khai, ảnh chụp màn hình hay tin nhắn chat.
Danh sách token
- Tên, kèm ngày tạo.
- Quyền: ví dụ Đọc sản phẩm hoặc Đọc đơn hàng.
- Quyền truy cập dữ liệu: 24 giờ qua, Toàn bộ dữ liệu hoặc Từ một ngày.
- Thời hạn: một ngày, hoặc Chưa bao giờ.
- Dùng lần cuối: lần cuối một công cụ dùng token, hoặc Chưa bao giờ.
Mỗi cửa hàng có số lượng token tối đa. Khi đạt đến mức đó, nút Tạo token mới biến mất cho đến khi bạn xóa bớt một token.
Sửa token
Nhấn vào một token để đổi tên, quyền, quyền truy cập dữ liệu hoặc thời hạn. Giá trị token giữ nguyên, nên công cụ đang dùng nó tiếp tục hoạt động với quy tắc mới.
Xóa token
Đánh dấu một hoặc nhiều token và chọn Xóa token, hoặc dùng nút thùng rác trên một dòng. Token ngừng hoạt động ngay lập tức, và mọi công cụ đang dùng nó sẽ gặp lỗi.
Mẹo
- Cấp cho mỗi công cụ một token riêng, để bạn có thể xóa một token mà không làm hỏng các công cụ khác.
- Chọn khoảng dữ liệu nhỏ nhất đủ dùng.
- Đặt ngày hết hạn cho người làm tự do và các công việc một lần.
- Token hiện Chưa bao giờ ở cột Dùng lần cuối trong thời gian dài có lẽ không còn cần thiết. Hãy xóa nó.
- Để Storeep chủ động đẩy sự kiện đơn hàng tới máy chủ của bạn thay vì máy chủ của bạn phải hỏi, hãy dùng webhook.