Kết nối cửa hàng

Kết nối và quản lý các cửa hàng TikTok

Một kịch bản cốt lõi đối với các nhà phát triển TikTok Shop API là triển khai chức năng tạo, quản lý và xóa một kết nối liên tục từ tài khoản khách hàng nội bộ của bạn đến TikTok Shop của khách hàng.

Quản lý các kết nối TikTok Shop

Một yêu cầu cơ bản cho trường hợp sử dụng này là lập chỉ mục dữ liệu khách hàng của bạn tới dữ liệu TikTok Shop của khách hàng. Việc này cho phép bạn tra cứu dữ liệu cần thiết để gọi TikTok Shop API thay mặt cho khách hàng từ kho dữ liệu của riêng bạn.

Một điều quan trọng cần lưu ý là bạn phải lưu trữ an toàn access token và refresh token TikTok Shop của khách hàng và liên kết chúng với dữ liệu nội bộ của khách hàng. Lý do là vì access token là thông tin xác thực bạn dùng để truy cập dữ liệu của khách hàng, nhưng nó không bao gồm bất kỳ thông tin định danh nào. Vì vậy, điều quan trọng là bạn phải liên kết các token này với dữ liệu khách hàng để có thể truy xuất chúng khi gọi TikTok Shop API.

Một điều cần lưu ý khác là bạn phải lưu trữ ngày và giờ hết hạn của access token để có thể kiểm tra xem access token đã hết hạn hay chưa và yêu cầu một token mới bằng refresh token.

Nếu bạn phục vụ những khách hàng có cửa hàng xuyên biên giới tại Trung Quốc, việc lưu trữ shop cipher liên kết với TikTok Shop của họ cũng rất quan trọng vì đây là tham số bắt buộc đối với các TikTok Shop tại Trung Quốc được kích hoạt bán hàng xuyên biên giới. Tham số này là tùy chọn đối với các cửa hàng nội địa ở các thị trường US, UK và SEA.

Cuối cùng, chúng tôi khuyến nghị bạn lưu trữ tất cả dữ liệu liên kết với một TikTok Shop vì dữ liệu này không thay đổi thường xuyên. Chúng tôi cũng khuyến nghị bạn triển khai chức năng trong ứng dụng client hoặc connector cho phép khách hàng tự làm mới dữ liệu TikTok Shop của họ, vì khách hàng nhiều khả năng sẽ biết khi nào họ đã thay đổi bất kỳ dữ liệu nào liên kết với TikTok Shop của mình.

Luồng gọi như sau:

1. Khách hàng của bạn ủy quyền cho TikTok Shop App của bạn truy cập dữ liệu TikTok Shop Seller của họ. Nếu TikTok Shop App của bạn được xuất bản trên TikTok Shop App Store, khách hàng ủy quyền cho TikTok Shop App của bạn khi họ nhấp vào nút install. Nếu không, bạn cung cấp một liên kết ủy quyền cho khách hàng để họ có thể đăng nhập bằng tài khoản TikTok Shop Seller của mình và nhấp vào nút để ủy quyền. Trong cả hai trường hợp, khi khách hàng đã ủy quyền, callback URL của bạn sẽ được gọi với một số tham số URL, bao gồm tham số code. Đây là một giá trị tạm thời, chỉ hợp lệ trong một khoảng thời gian giới hạn và chỉ có thể dùng một lần, nên bạn không cần lưu trữ nó.
2. Lấy access token và refresh token bằng cách gọi endpoint xác thực của TikTok Shop API, truyền giá trị của tham số code từ bước 1 vào query parameter auth_code.
3. Nếu thành công, bạn sẽ nhận được phản hồi HTTP 200 với một body phản hồi JSON. Body phản hồi JSON bao gồm access_token, là bearer token bạn dùng để gọi TikTok Shop API, access_token_expire_in, là ngày mà access_token hết hạn ở định dạng thời gian Unix epoch, refresh_token, là refresh token bạn sẽ truyền khi access_token hết hạn và bạn cần một token mới, và cuối cùng là refresh_token_expire_in là ngày mà refresh_token hết hạn và bạn buộc phải yêu cầu khách hàng ủy quyền lại cho TikTok Shop App của bạn và lặp lại quy trình này từ bước 1.
4. Lưu trữ access_token, access_token_expire_in, refresh_token, và refresh_token_expire_in trong kho dữ liệu bí mật của bạn, được lập chỉ mục tới định danh khách hàng nội bộ của bạn để bạn có thể truy xuất dữ liệu này khi sẵn sàng thực hiện một lệnh gọi TikTok Shop API.

Kết nối một cửa hàng đơn lẻ

Trong trường hợp sử dụng này, bạn kết nối một cửa hàng đơn lẻ của khách hàng trong ứng dụng client của bạn tới một TikTok Shop. Triển khai trường hợp sử dụng này nếu bạn dự kiến khách hàng chỉ có một TikTok Shop và bạn không dự kiến phục vụ những khách hàng có nhiều TikTok Shop trong tương lai. Nếu bạn muốn cho phép khách hàng có nhiều TikTok Shop, hãy triển khai trường hợp sử dụng kết nối nhiều cửa hàng thay vào đó.

Để kết nối một cửa hàng đơn lẻ, schema kho dữ liệu nội bộ của bạn phải bao gồm một định danh khách hàng nội bộ. Trong sơ đồ luồng gọi, điều này được biểu diễn bằng cột CustomerID trong cơ sở dữ liệu ví dụ.

Luồng gọi như sau:

1. Truy xuất giá trị access_token.
2. Gọi Get Authorized Shops API, truyền giá trị của trường access_token mà bạn đã truy xuất ở bước 1 vào header x-tts-access-token
3. Phản hồi bao gồm một trường tên là data là một danh sách các object biểu diễn dữ liệu về một TikTok Shop. Trong trường hợp sử dụng cửa hàng đơn lẻ này, sẽ chỉ có một object duy nhất.
4. Lưu trữ dữ liệu TikTok Shop từ bước 3 trong kho dữ liệu nội bộ của bạn, được lập chỉ mục tới định danh cửa hàng của khách hàng.

Kết nối nhiều cửa hàng

Triển khai trường hợp sử dụng này nếu bạn dự kiến khách hàng có nhiều hơn một TikTok Shop liên kết với tài khoản TikTok Seller của họ.

Để kết nối nhiều cửa hàng, schema kho dữ liệu nội bộ của bạn phải bao gồm một định danh khách hàng nội bộ. Trong sơ đồ luồng gọi, điều này được biểu diễn bằng cột CustomerID trong cơ sở dữ liệu ví dụ. Lưu ý rằng cột này không thể là unique key vì nó sẽ bao gồm nhiều hàng, mỗi hàng cho một TikTok Shop.

Luồng gọi như sau:

1. Truy xuất giá trị access_token.
2. Gọi Get Authorized Shops API, truyền giá trị của trường access_token mà bạn đã truy xuất ở bước 1 vào header x-tts-access-token
3. Phản hồi bao gồm một trường tên là data là một danh sách các object biểu diễn dữ liệu về một TikTok Shop. Mỗi object biểu diễn dữ liệu về một TikTok Shop.
4. Duyệt qua các object trong danh sách object dữ liệu TikTok Shop từ bước 3, và lưu trữ mỗi object trong một hàng mới trong kho dữ liệu nội bộ của bạn, được lập chỉ mục tới định danh cửa hàng của khách hàng.

Các bước tiếp theo

Sau khi bạn đã kết nối một hoặc nhiều TikTok Shop, bạn có thể triển khai một webhook listener cho việc hết hạn ủy quyền thêm chức năng để ngắt kết nối một cửa hàng.