Chuyển tới nội dung chính

Gọi API Get Authorized Shops

Sau khi bạn đã hoàn thành bước cuối cùng là tạo mã băm mật mã để ký yêu cầu của bạn, cuối cùng bạn đã sẵn sàng thực hiện lệnh gọi đầu tiên đến TikTok Shop API.

Bây giờ chúng ta đã có tất cả các giá trị tham số bắt buộc, chúng ta có thể gọi Get Authorized Shops API. Đối với lệnh gọi này, chúng ta phải truyền access_token trong header x-tts-access-token, vì vậy bạn sẽ cần sử dụng một công cụ như cURL để tạo yêu cầu.

ParameterLocationTypeDescription
app_keyQuerystringApp key được tạo khi bạn tạo TikTok Shop App của mình. Bạn có thể lấy giá trị này bằng cách truy cập TikTok Shop Partner Center Console, chọn App & Service từ thanh điều hướng bên trái, nhấp vào thẻ TikTok Shop Application của bạn trong khung App & service, sau đó cuộn xuống mục Developing.
signQuerystringMã băm mật mã mà bạn đã tạo trong tạo mã băm để ký lệnh gọi API thử nghiệm của bạn.
timestampQueryUnix timestampDấu thời gian Unix epoch mà bạn đã dùng để tạo tham số sign ở trên. Lưu ý rằng dấu thời gian dùng để tạo mã băm mật mã và giá trị bạn tạo cho lệnh gọi API này không được cách nhau quá năm phút.
x-tts-access-tokenHeaderstringAccess token thử nghiệm mà bạn đã tạo khi tạo access token thử nghiệm.

Đối với yêu cầu HTTP này, bạn bắt buộc phải thêm các header. Nếu bạn không tạo yêu cầu bằng mã lập trình thông qua một thư viện HTTP trong ngôn ngữ lập trình bạn ưa thích, bạn sẽ cần sử dụng một công cụ như cURL.

Nếu bạn sử dụng cURL, lệnh gọi API đầu tiên của bạn sẽ trông giống như:

TEXTWord Wrap

curl   --location --request GET 'https://open-api.tiktokglobalshop.com/authorization/202309/shops?app_key=<your App key>&sign=<your cryptographic hash>&timestamp=<a timestamp within 5 minutes of when the sign parameter was created>'      
--header 'Content-Type: application/json'     
--header 'x-tts-access-token: <your access token>'

Nếu yêu cầu của bạn thành công, bạn sẽ nhận được phản hồi sau:

JSONWord Wrap

{
  "code": 0,
  "data": {
    "shops": [
      {
        "cipher": "<the shop cipher for your test TikTok Shop>",
        "code": "<the shop code for your test TikTok Shop>",
        "id": "<the identifier for your test TikTok Shop>",
        "name": "<the name of your test TikTok Shop>",
        "region": "<the region of your test TikTok Shop>",
        "seller_type": "<your seller type>"
      }
    ]
  },
  "message": "Success",
  "request_id": "<the request identifier generated by the TikTok Shop server>"
}

Khắc phục sự cố​

Hai vấn đề phổ biến nhất mà bạn có thể gặp phải thường liên quan đến giá trị access token của bạn trong header x-tts-access-token hoặc mã băm mật mã mà bạn đã tạo cho tham số sign.

Nếu yêu cầu của bạn thất bại do vấn đề xác thực, vui lòng đảm bảo rằng bạn đã thực hiện chính xác tất cả các bước trong tạo access token thử nghiệm. Nếu bạn vẫn gặp vấn đề về xác thực, có thể bạn đang gặp sự cố với TikTok Shop App hoặc tài khoản Seller TikTok Shop thử nghiệm của bạn. Bạn có thể liên hệ với bộ phận hỗ trợ kỹ thuật để giúp bạn giải quyết các vấn đề này.

Nếu yêu cầu của bạn thất bại do tham số sign không hợp lệ, vui lòng xem lại nội dung trong ký yêu cầu API của bạn vì nội dung đó toàn diện hơn nhiều so với nội dung hướng dẫn bắt đầu. Nếu bạn vẫn gặp vấn đề, vui lòng liên hệ với bộ phận hỗ trợ kỹ thuật để được hỗ trợ.

Các bước tiếp theo​

Bây giờ bạn đã thực hiện thành công lệnh gọi API đầu tiên, bạn đã sẵn sàng bắt đầu phát triển TikTok Shop App của mình. Hãy chuyển đến hướng dẫn dành cho nhà phát triển để tìm hiểu về: