my.getAddress
getAddress
my.getAddress
là API dùng để chọn một địa chỉ từ Sổ địa chỉ của Tiki. Yêu cầu người dùng phải đăng nhập trước
Khả dụng: Hỗ trợ từ version 1.77.14 trở lên.
Quét mã để trải nghiệm
Xem code mẫu trên Tini StudioDemo
Trải nghiệm thử với trình giả lập bên dưới
API Params
Thuộc tính | Kiểu dữ liệu | Mô tả |
---|---|---|
success | Function | Callback function khi một địa chỉ từ Sổ địa chỉ được chọn |
fail | Function | Callback function khi user không chọn địa chỉ nào, hoặc có lỗi xảy ra trong quá trình chọn địa chỉ, argument sẽ là error message |
complete | Function | Callback function khi việc mở màn hình kết thúc cho dù thành công hay thất bại. |
Callback function payload
- success callback payload là 1 địa chỉ được chọn, bạn có thể xem thông tin địa chỉ bên dưới
- fail callback payload
Thuộc tính | Kiểu dữ liệu | Mô tả |
---|---|---|
error | string | error title |
errorMessage | string | error message in detail. Các lỗi thường gặp là: No item selected , khi mà user không chọn địa chỉ nào hoặc Permission denied khi user không cấp quyền để truy cập Sổ địa chỉ |
Thông tin địa chỉ được trả về
Thuộc tính | Kiểu dữ liệu | Mô tả |
---|---|---|
id | number | Id của địa chỉ |
full_name | string | Tên người nhận |
phone_number | string | Số điện thoại người nhận |
is_default | boolean | Có phải là địa chỉ mặc định trong Sổ địa chỉ hay không |
company | string / null | Tên công ty của người nhận |
street | string | Tên đường |
delivery_address_type | home / company | Loại địa chỉ: home hoặc company |
country | string | Tên quốc gia |
country_id | number | Mã quốc gia |
city_id | number | Mã thành phố |
city | string | Tên thành phố |
district_id | number | Mã quận/huyện |
district | string | Tên quận/huyện |
ward_id | number | Mã phường/xã |
ward | string | Tên phường/xã |
Sample Code
index.js
Page({
onLoad() {
my.getAddress({
success: (res) => {
console.log('address: ', res);
},
fail: (res) => {}
});
}
});