Ngôn ngữ

Ngôn ngữ văn bản sản phẩm được đặt bằng language trong API JSON body — không phải qua locale URL của Portal (/en so với /zh).

Giá luôn là CNY

API không chấp nhận currency và không chuyển đổi ngoại tệ. Response chuẩn dùng original_currency và display_currency là CNY với cùng số tiền theo yuan. Nếu cần, hãy tự chuyển đổi ở phía bạn.

Trường request

Field	Required	Default	Description
`language`	No	`en`	Locale dịch cho tiêu đề, thuộc tính, kết quả tìm kiếm.

Ví dụ

POST /v1/products/search

{
  "channel": "1688",
  "keyword": "phone case",
  "language": "ja",
  "page": 1,
  "page_size": 10
}

Mapping kênh

Bảng locale đầy đủ nằm trong data/language-mappings.json. Tóm tắt:

1688 mapping

Enum ngôn ngữ chính thức mới nhất của 1688 (country). Tiếng Trung giản thể (zh / zh-CN / cn) không còn được hỗ trợ — Gateway fallback về en.

Bạn gửi	Mã 1688	Ghi chú
`en`	`en`	Tiếng Anh
`ja`	`ja`	Tiếng Nhật
`ko`	`ko`	Tiếng Hàn
`ru`	`ru`	Tiếng Nga
`vi`	`vi`	Tiếng Việt
`fr`	`fr`	Tiếng Pháp
`pt`	`pt`	Tiếng Bồ Đào Nha
`zh-tw` / `zh_TW`	`zh-tw`	Tiếng Trung phồn thể
`es`	`es`	Tiếng Tây Ban Nha
`id`	`id`	Tiếng Indonesia
`th`	`th`	Tiếng Thái

Taobao mapping

Bạn gửi	Mã IOP	Ghi chú
`en`	`en`	Tiếng Anh
`vi`	`vi`	Tiếng Việt
`ru`	`ru`	Tiếng Nga
`ko`	`ko`	Tiếng Hàn
`ja`	`ja`	Tiếng Nhật
`zh` / `zh-CN` / `cn`	`cn`	Tiếng Trung

Xem Product search và Product detail để biết ví dụ với language.

Get Support

Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days

Email support