Hàm lấy thông tin trạng thái ZNS

Đây là hàm dùng để truy xuất trạng thái của thông báo ZNS.

Lưu ý: Giới hạn tốc độ gọi api này là 30 requests/giây.

HTTP request

POST http://rest.esms.vn/MainService.svc/json/GetZaloMessageStatus

• Content Type: application/json

• Response Type: application/json

curl --location 'http://rest.esms.vn/MainService.svc/json/GetZaloMessageStatus' \
--header 'Content-Type: application/json' \
--data '{
    "ApiKey": "{{ApiKey}}",
    "SecretKey": "{{SecretKey}}",
    "OAID": "{{OAID}}",
    "MessageId": "{{MessageId}}"
}'

• Cấu trúc body của request:

Tham số	Kiểu dữ liệu	Tính bắt buộc	Mô tả
ApiKey	string		ApiKey của tài khoản.
SecretKey	string		SecretKey của tài khoản.
OAID	string		Zalo OA ID, là ID của trang Zalo Offical Account của doanh nghiệp. Doanh nghiệp cần đăng nhập vào trang quản trị của Zalo OA để lấy phần Zalo OA ID này. Chú ý: sẽ phải đăng ký trước khi sử dụng.
MessageId	string		ID của thông báo cần lấy thông tin trạng thái ZNS (chính là Partnerids được trả về trong hàm lấy thông tin callback tin nhắn zalo)

---

• Response:

100

{
    "CodeResult": "100",
    "Data": {
        "delivery_time": "1767678030984",
        "message": "The message was delivered to the user's phone",
        "status": 1
    },
    "ErrorMessage": "success. "
}

Request hợp lệ.

• Cấu trúc body của response:

Thuộc tính	Kiểu dữ liệu	Mô tả
CodeResult	string	Kết quả của Request.
ErrorMessage	string	Thông báo kết quả trả về.
Data	string	Thông tin trạng thái của thông báo ZNS .

• Cấu trúc thuộc tính từng object trong Data:

Thuộc tính	Kiểu dữ liệu	Mô tả
delivery_time	string	Thời gian thiết bị của người dùng nhận được thông báo ZNS.
message	string	Mô tả trạng thái thông báo. Các giá trị trả về: -1: Tin nhắn không tồn tại 0: Tin nhắn đã được gửi lên máy chủ Zalo nhưng chưa được chuyển đến điện thoại của người dùng 1: Tin nhắn đã được chuyển đến điện thoại của người dùng
status	int	Trạng thái của thông báo ZNS.

• Thông tin chi tiết mã lỗi xem ở bảng: Mã lỗi .

• Lấy code mẫu các ngôn ngữ trên Postman: Link code mẫu.