Phạm vi truy cập (Access scope)
Hiểu về cách hoạt động của phạm vi truy cập
Khi phát triển một app cho TikTok Shop, việc xác định chính xác dữ liệu mà bạn cần truy cập là điều thiết yếu. Đây là lúc phạm vi truy cập (access scope) phát huy vai trò. Phạm vi truy cập đóng vai trò như người gác cổng, giới hạn quyền truy cập của app vào một số dữ liệu nhất định (các API cụ thể). Chúng cung cấp phương tiện để xác định chính xác loại quyền truy cập mà app của bạn cần.
Quan trọng không kém là sự rõ ràng mà các phạm vi này mang lại cho người bán — những người cấp quyền cho app của bạn truy cập dữ liệu của họ. Người bán cần biết phạm vi khả năng và giới hạn của một app đối với dữ liệu của họ trên tài khoản Seller Center. Khi cấp cho một app quyền truy cập dữ liệu, mỗi phạm vi sẽ xác định rõ các endpoint mà app có thể truy cập. Ví dụ, một app có thể được cấp quyền truy cập dữ liệu đơn hàng và sản phẩm trong một cửa hàng.
| Type of access scopes | Description |
|---|---|
| Public | Các API thuộc nhóm phạm vi public có thể truy cập bởi tất cả nhà phát triển. Những API này là nền tảng để xây dựng các chức năng app hỗ trợ người bán TikTok Shop. Khi tạo một app trong Partner Center, theo mặc định bạn sẽ có quyền truy cập tất cả các API thuộc phạm vi public. Tuy nhiên, app của bạn cần được người bán cấp quyền trước khi có thể truy cập dữ liệu cụ thể liên quan đến cửa hàng. |
| Custom | Các API thuộc nhóm phạm vi custom chứa dữ liệu nhạy cảm. Để truy cập các API trong phạm vi này, bạn có thể đăng ký quyền truy cập qua Partner Center, bằng cách điều hướng đến Partner Console >> App & Service >> Manage >> Manage API. Tương tự phạm vi public, app của bạn cần được người bán cấp quyền trước khi truy cập dữ liệu cụ thể liên quan đến cửa hàng. |
Danh sách các phạm vi truy cập khả dụng
Bảng sau liệt kê một số ví dụ về phạm vi truy cập cho các API của TikTok Shop.
📌 Để xem danh sách đầy đủ các phạm vi truy cập API khả dụng cho app của bạn, vui lòng truy cập Partner Console >> App & Service >> Manage >> Manage API.
| Scope Name | Description | Type |
|---|---|---|
| Shop Authorized Information | Đối tác sẽ có quyền truy cập (các) shop ID TikTok Shop của người bán. | Public |
| Product Basic | Đối tác sẽ có thể đồng bộ thông tin sản phẩm tới (các) cửa hàng TikTok Shop của người bán. | Public |
| Product Modify | Đối tác sẽ có thể quản lý thông tin sản phẩm của người bán, bao gồm quyền truy cập danh sách sản phẩm, chỉnh sửa thuộc tính sản phẩm, thay đổi trạng thái sản phẩm và đồng bộ tồn kho sản phẩm, v.v. | Public |
| Product Delete & Recover | Đối tác sẽ có thể quản lý sản phẩm của người bán, xóa và khôi phục sản phẩm khỏi gian trưng bày. | Public |
| Order Information | Đối tác sẽ có thể truy cập toàn bộ dữ liệu đơn hàng của người bán theo thời gian thực qua API. | Public |
| Fulfillment Basic | Đối tác sẽ có thể thực hiện và quản lý đơn hàng thay cho người bán, đồng thời cung cấp cập nhật trạng thái đơn hàng của người bán theo thời gian thực. | Public |
| Package Split And Combine | Đối tác sẽ có thể tách và gộp đơn hàng thay cho người bán. | Public |
| Update Delivery Status | Đối tác sẽ có thể đẩy một kiện hàng sang trạng thái đã giao cho người bán có năng lực vận chuyển (giao hàng 3PL). | Public |
| Logistics Basic | Đối tác sẽ có thể lấy thông tin vận chuyển và kho hàng của người bán. | Public |
| Return & Refund Basic | Đối tác sẽ có thể quản lý các yêu cầu trả hàng và hoàn tiền của người bán. | Public |
| Finance Information | Đối tác sẽ có thể truy cập thông tin giao dịch và số tiền quyết toán theo đơn hàng, đồng thời đối chiếu các khoản quyết toán của người bán từ TikTok Shop với đơn hàng. | Public |
| Promotion Information | Đối tác sẽ có thể lấy danh sách khuyến mãi và chi tiết sự kiện khuyến mãi của người bán. | Public |
| Promotion Modify | Đối tác sẽ có thể tạo và quản lý các chương trình giảm giá và khuyến mãi của người bán trên TikTok Shop. | Public |
| Global Shop Information | Đối tác sẽ có thể truy cập thông tin cửa hàng toàn cầu của người bán. | Public |
| Global Product Information | Đối tác sẽ có thể truy cập thông tin sản phẩm toàn cầu của người bán. | Public |
| Global Product Modify | Đối tác sẽ có thể quản lý thông tin sản phẩm toàn cầu của người bán, v.v. | Public |
| Global Product Delete | Đối tác sẽ có thể xóa sản phẩm toàn cầu thay cho người bán. | Public |
| Global Category Information | Đối tác sẽ có thể truy cập thông tin danh mục sản phẩm toàn cầu của người bán. | Public |
| và nhiều hơn nữa... |