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

Errors

Bắt đầu hỗ trợ ở phiên bản:

  • SDK: 2.21.0

Hướng dẫn xử lý lỗi​

Hầu hết các API trong ZMP SDK đều trả về Promise khi sử dụng, vì vậy bạn có thể lấy kết quả trả về và xử lý lỗi như sau:

1. Sử dụng async/await kết hợp với try/catch (khuyến khích)​

async/await là một cơ chế hiện đại của JavaScript, được hỗ trợ ở hầu hết các môi trường web hiện nay. Việc sử dụng async/await giúp xử lý các logic bất đồng bộ một cách tuyến tính, tránh rơi vào tình trạng callback hell.

const { userInfo } = await getUserInfo({
  autoRequestPermission: true,
});
const { orders } = await fetchOrders({
  userId: userInfo.id,
});
console.log("Các đơn hàng của người dùng: ", orders);
Lưu ý:

await phải được gọi bên trong hàm async. Ví dụ:

function login() { // ❌ Không thể dùng await trong một hàm thông thường, do JavaScript là non-blocking
    await getUserInfo();
}
async function login() { // ✅ Hợp lệ
    await getUserInfo();
}

Để xử lý lỗi khi sử dụng async/await, bạn có thể dùng try/catch như thông thường:

try {
    const { userInfo } = await getUserInfo({
        autoRequestPermission: true,
    });
    const { orders } = await fetchOrders({
        userId: userInfo.id,
    });
} catch (error) {
    if (error instanceof AppError) {
        if (error.code === -1401) {
            // Người dùng từ chối cung cấp tên và ảnh đại diện
        }
        // Lỗi khác khi gọi `getUserInfo`
    } else {
        // Lỗi khác khi gọi `fetchOrders`
    }
}

2. Sử dụng các method của Promise như .then() và .catch()​

Cách này có thể sử dụng nếu bạn không muốn chuyển context hiện tại sang async. Tuy nhiên, nếu cần chain nhiều method, cách này có thể dẫn đến callback hell:

getUserInfo({
  autoRequestPermission: true,
}).then(({ userInfo }) => {
  fetchOrders({
    userId: userInfo.id,
  }).then((orders) => {
    console.log("Các đơn hàng của người dùng: ", orders);
  });
});

Để xử lý lỗi khi sử dụng .then(), bạn cần dùng .catch():

getUserInfo({
  autoRequestPermission: true,
})
  .then(({ userInfo }) => {
    fetchOrders({
      userId: userInfo.id,
    })
      .then((orders) => {
        console.log("Các đơn hàng của người dùng: ", orders);
      })
      .catch((error) => {
        // Lỗi khi gọi `fetchOrders`
      });
  })
  .catch((error) => {
    if (error instanceof AppError) {
      if (error.code === -1401) {
        // Người dùng từ chối cung cấp tên và ảnh đại diện
      }
      // Lỗi khác khi gọi `getUserInfo`
    }
  });

3. Sử dụng callback success và fail của ZMP SDK​

Tất cả API của ZMP SDK hỗ trợ truyền vào 2 callback đặc biệt là success và fail. Callback success sẽ được gọi khi API thành công và trả về kết quả:

Lưu ý:

Khi sử dụng các callback này, API sẽ không trả về Promise nữa.

getUserInfo({
  autoRequestPermission: true,
  success: ({ userInfo }) => {
    fetchOrders({
      userId: userInfo.id,
      success: (orders) => {
        console.log("Các đơn hàng của người dùng: ", orders);
      },
    });
  },
});

Để xử lý lỗi, bạn có thể truyền callback fail tương tự:

getUserInfo({
  autoRequestPermission: true,
  success: ({ userInfo }) => {
    fetchOrders({
      userId: userInfo.id,
      success: (orders) => {
        console.log("Các đơn hàng của người dùng: ", orders);
      },
      fail: (error) => {
        // Lỗi khi gọi `fetchOrders`
      },
    });
  },
  fail: (error) => {
    if (error.code === -1401) {
      // Người dùng từ chối cung cấp tên và ảnh đại diện
    }
    // Lỗi khác khi gọi `getUserInfo`
  },
});

Bảng đặc tả mã lỗi​

  • Các mã lỗi không đề cập API(s) áp dụng với tất cả API trong ZMP SDK.
  • Các mã lỗi > 0 là lỗi khi tích hợp Server-Server, ví dụ như truy xuất số điện thoại từ token của getPhoneNumber.
CodeMessageNoteAPI(s)
-1400Bad request

Tham số truyền vào API không hợp lệ.

-1401User Authentication Required. Please grant User Authentication permission before requesting User Permission

Người dùng chưa cấp thông tin xác thực. Vui lòng tham khảo thêm tại getAccessToken.

getLocation
getPhoneNumber
-1403You don't have permission to call this api

Bạn cần xin cấp quyền tại trang Quản lý ứng dụng.

-1404This API is not supported in this Zalo version

Vui lòng cập nhật Zalo để sử dụng các API mới.

-1408Request timeout. Please try again later.

Yêu cầu mất quá nhiều thời gian để xử lý, vui lòng thử lại sau.

-2000Unknown error. Please try again later.

Đã xảy ra lỗi không xác định, vui lòng thử lại sau.

-2001Can not decode id. Please check your params again.

Id truyền vào API không hợp lệ.

-2002User denied

Người dùng đã từ chối cấp quyền trước đó và không muốn hỏi lại.

getLocation
getPhoneNumber
requestCameraPermission
requestSendNotification
openSMS
-2003User cancel

Người dùng đã hủy thao tác chọn media.

openMediaPicker
openProfilePicker
-2004Unable to pick media

Không thể chọn media. Vui lòng kiểm tra lại kết nối mạng hoặc máy chủ upload.

openMediaPicker
-2005Unable to save media

Không thể lưu media vào thư viện ảnh.

saveImageToGallery
-2006Unable to save video

Không thể lưu video vào thư viện.

saveVideoToGallery
-201User deny request permission!

Người dùng đã từ chối cấp quyền truy cập.

getLocation
getPhoneNumber
requestSendNotification
followOA
interactOA
unfollowOA
-202User deny request permission!

Người dùng từ chối cấp quyền và chọn không hỏi lại lần sau.

getLocation
getPhoneNumber
requestSendNotification
-203This action reached the limit

Bạn đã vượt quá số lần gọi API cho phép.

-301Your device run out of storage

Thiết bị của bạn đã hết dung lượng lưu trữ.

downloadFile
-302File cannot be found. Please check your param again.

Không tìm thấy file. Có thể do đường dẫn sử dụng http (chỉ hỗ trợ https) hoặc file không tồn tại.

downloadFile
-303Please wait... We're still download the file.

File đang được tải xuống, vui lòng chờ trong giây lát.

downloadFile
-304No Internet connection. Please check your network settings.

Không có kết nối Internet. Vui lòng kiểm tra lại mạng của bạn.

downloadFile
-305Download failed. Please check your network or file path again.

Tải file thất bại. Vui lòng kiểm tra lại kết nối mạng hoặc đường dẫn file.

downloadFile
-306File type unsupported

Định dạng file không được hỗ trợ. Tham khảo danh sách file hỗ trợ.

downloadFile
100Unknown error

Đã xảy ra lỗi không xác định khi xác thực sinh trắc học.

openBioAuthentication
101Xác thực thất bại 3 lần (Android)

Người dùng xác thực thất bại 3 lần liên tiếp trên Android.

openBioAuthentication
102Hủy xác thực

Người dùng đã hủy quá trình xác thực.

openBioAuthentication
103Xác thực không thành công (Bấm nhập mật khẩu - iOS)

Xác thực sinh trắc học không thành công, người dùng đã chọn nhập mật khẩu trên iOS.

openBioAuthentication
108Xác thực quá nhiều lần => Đã bị khóa Biometic

Bạn đã xác thực quá nhiều lần, chức năng xác thực sinh trắc học đã bị khóa.

openBioAuthentication
114code is empty

Tham số code truyền vào đang bị rỗng.

getLocation
getPhoneNumber
115code is invalid

Tham số code truyền vào không hợp lệ.

getLocation
getPhoneNumber
116secret_key is empty

Tham số secret_key truyền vào đang bị rỗng.

getLocation
getPhoneNumber
117secret_key is invalid

Tham số secret_key truyền vào không hợp lệ.

getLocation
getPhoneNumber
118code is invalid

Tham số code không hợp lệ, thuộc về một ứng dụng khác.

getLocation
getPhoneNumber
119code has already been used

Code này đã được sử dụng trước đó.

getLocation
getPhoneNumber

Errors

zi-chevron-up
miniapp-logo

Khám phá