Lấy chi tiết 1 tin nhắn V2 ( Bao gồm SMS và ZNS )

Khi có nhu cầu lấy thông tin của 1 tin ZNS/SMS ví dụ như trạng thái, thời gian khởi tạo... thì chúng ta có thể sử dụng api này. — Sử dụng API V2 này trong trường hợp cần tìm kết quả tin nhắn cuối cùng khi có dùng fallback

1. Lấy kết quả tin ZNS

HTTP request

• URL: https://apis-sandbox.infinix.vn/v1/zns/{{api-key-slug}}/result-v2/{{sessionId}}

• Method: GET

• Content Type: application/json

Example request

curl --location 'https://apis.infinix.vn/v1/zns/zns-api-key-monitor/result-v2/1c62e4dc-c959-478d-a5f4-3434bf5ad608' \
--header 'api-key: 819062eum09882ce346db53fa00kd7q1p1' \
--data ''

Example response

{
    "success": true,
    "data": {
        "sessionId": "1c62e4dc-c959-478d-a5f4-3434bf5ad608",
        "znsInfo": {
            "phone": "8436365****",
            "status": "RECEIVED",
            "type": "NORMAL",
            "createdAt": "2024-10-08T02:51:29.933Z",
            "isCharged": true,
            "sendingMode": "1",
            "error": null
        }
    },
    "meta": {
        "sessionId": "e1b5dc53-f8b0-41d3-97c7-4ce0d56f8dde"
    }
}

2. Lấy kết quả tin SMS

HTTP request

• URL: https://apis-sandbox.infinix.vn/v1/sms/{{api-key-slug}}/result-v2/{{sessionId}}

• Method: GET

• Content Type: application/json

Example request

curl --location 'https://apis.infinix.vn/v1/sms/zns-api-key-monitor/result-v2/1c62e4dc-c959-478d-a5f4-3434bf5ad608' \
--header 'api-key: 819062eum09882ce346db53fa00kd7q1p1' \
--data ''

Example response

{
    "success": true,
    "data": {
        "sessionId": "1c62e4dc-c959-478d-a5f4-3434bf5ad608",
        "znsInfo": {
            "phone": "8436365****",
            "status": "RECEIVED",
            "type": "NORMAL",
            "createdAt": "2024-10-08T02:51:29.933Z",
            "isCharged": true,
            "error": null
        }
    },
    "meta": {
        "sessionId": "e1b5dc53-f8b0-41d3-97c7-4ce0d56f8dde"
    }
}

Cấu trúc các thuộc tính response

Tham số	Kiểu dữ liệu
phone	String	Số điện thoại người nhận
type	String	Loại tin ZNS được gửi
sessionId	String	Mỗi request sẽ sinh ra 1 sessionId để nhận diện
createdAt	Date	Thời gian khởi tạo request
status	String	Trạng thái của request
isCharged	Boolean	Xác định tin nhắn có bị tính tiền hay không. Biến này chỉ có trong trường hượng status của tin nhắn là RECEIVED Ý nghĩa của giá trị biến là - true: Tính tiền - false: Không tính tiền
sendingMode	String	Kết quả của cơ chế gửi ZNS Promotion, bao gồm: "1" hoặc "3" tương ứng với 1: Gửi cơ chế bình thường 3: Gửi cơ chế vượt hạn mức Chỉ có với tin nhắn SMS