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

GET Get Return Records

Get Return Records Shop Scope bắt buộc: seller.return_refund.basic Sử dụng API này để truy xuất các bản ghi cho một yêu cầu trả hàng cụ thể. Mỗi mục trong data.records đại diện cho một hành động hoặc sự kiện vòng đời cho return_id được chỉ định. Version 202309

GET/return_refund/202309/returns/{return_id}/records

Request

Path

PropertiesTypeDescription
return_id RequiredstringMã định danh duy nhất cho một yêu cầu trả hàng TikTok Shop.

Header

PropertiesTypeDescription
content-type RequiredstringKiểu được phép: application/json
x-tts-access-token RequiredstringGiá trị access_token của người bán từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy access_token của người bán.

Query

PropertiesTypeDescription
app_key RequiredstringMỗi app sẽ có một key duy nhất. Vui lòng sử dụng key cụ thể được gán cho app của bạn.
sign RequiredstringChữ ký được tạo bởi thuật toán gen. Khi bạn gửi các request API đến TTS, bạn phải ký chúng để TTS có thể nhận diện người gửi.
timestamp RequiredintUnix timestamp GMT (UTC+00:00). Timestamp này được sử dụng trên tất cả các request API. Nhà phát triển có thể dùng cái này để chuyển đổi sang giờ địa phương.
localestringMã locale BCP-47 để hiển thị lý do trả hàng, phân tách bằng dấu phẩy. Mặc định: en-USTham khảo Locale codes để xem danh sách mã locale được hỗ trợ.
shop_cipher RequiredstringSử dụng thuộc tính này để truyền thông tin shop khi gọi API. Việc không truyền đúng giá trị khi gọi API cho các shop xuyên biên giới sẽ trả về phản hồi không chính xác. Lấy bằng API Get Authorization Shop

Example

CurlGoNode.jsJavaEnable word wrap

Response Parameters

PropertiesTypeDescription
codeintMã trạng thái thành công hoặc thất bại được trả về trong phản hồi API.
messagestringCác thông báo thành công hoặc thất bại được trả về trong phản hồi API. Lý do thất bại sẽ được mô tả trong message.
request_idstringNhật ký request
dataobjectThông tin trả hàng cụ thể

Example

JSONEnable word wrap

Error Code

View common error codes

| Code | Message | | --- | --- | | Empty. No business logic error codes. |

Nội dung này có hữu ích không?Hữu ích

Không hữu ích

PreviousNext