getPhoneNumber
Bắt đầu hỗ trợ ở phiên bản:
- API: 2.13.0
Với API version ﹤ 2.23.0, phải gọi api login trước khi gọi api này và cần xin cấp quyền tại trang Quản lý ứng dụng
Lấy thông tin số điện thoại của người dùng. Một thông báo xin cấp quyền sẽ được hiển thị sau khi gọi api. Chỉ lấy được thông tin số điện thoại nếu người dùng đồng ý cấp quyền.
Thông báo xin người dùng cấp quyền truy cập số điện thoại
Parameters
Object object
| Property | Type | Default | Required | Description | Minimum Version |
|---|---|---|---|---|---|
| success | function | Callback function khi gọi api thành công | |||
| fail | function | Callback function khi gọi api thất bại |
Return Values
Từ phiên bản Zalo 23.02.01 trên hệ điều hành Android và iOS, nhằm tăng cường tính xác thực và bảo mật cho dữ liệu, đồng thời đảm bảo việc sử dụng thông tin người dùng trên Zalo Mini App được tối ưu hóa, Zalo Mini App Platform sẽ tiến hành cập nhật mới luồng cấp quyền từ người dùng (Permissions). Chi tiết tham khảo tại dây
Promise<Object data>
| Property | Type | Description | Minimum Version | Note |
|---|---|---|---|---|
| token | string | Là một chuỗi ký tự dùng để truy xuất thông tin số điện thoại thông qua server | Zalo App: 23.02.01, SDK: 2.24.0 | |
| number | string | Thông tin số điện thoại của người dùng | Không còn được hỗ trợ từ phiên bản Zalo 23.02.01 trên cả hệ điều hành Android và iOS |
Sample Code
import { getPhoneNumber } from 'zmp-sdk/apis';
const getPhoneNumberByToken = async (token) => {
// gọi API Server của bạn để truy xuất thông tin từ token và user access token
};
const getUserPhoneNumber = () => {
getPhoneNumber({
success: async (data) => {
// xử lý khi gọi api thành công
let { token, number } = data;
// xử lý cho trường hợp sử dụng phiên bản Zalo mới (phiên bản lớn hơn 23.02.01)
if (token) {
number = await getPhoneNumberByToken(token);
}
},
fail: (error) => {
// xử lý khi gọi api thất bại
console.log(error);
}
});
};
Errors
Bắt đầu hỗ trợ:
- API phiên bản: 2.21.0
| Code | Message | Note |
|---|---|---|
| -2002 | User denied |
Để giúp các nhà phát triển Mini App sử dụng flow xin quyền một cách hiệu quả, cũng như phù hợp với chính sách của Zalo Mini App điều 3.3.4. Mini App Team đã đưa ra một số gợi ý thiết kế trải nghiệm như thông tin bên dưới. Nhà phát triển cần giải thích rõ ràng và trực quan mục đích xin quyền để người dùng dễ dàng hiểu và đồng ý cung cấp thông tin.
Nhằm đảm bảo trải nghiệp thoải mái đến người dùng Mini App của bạn, chúng tôi sẽ từ chối xét duyệt cho những Mini App có Flow Permission chưa rõ ràng, không nêu được mục đích xin quyền đến người dùng. Tham khảo một số trường hợp vi phạm như bên dưới:
