Quyền truy cập tài khoản và dự án
Sử dụng tài khoản API đã được kích hoạt qua HTTPS từ địa chỉ IP được cho phép. Dự án phải thuộc tài khoản đó và chưa bị xóa. Sử dụng mã định danh duy nhất của dự án từ quy trình đặt lệnh chuyển mạng giữ số, không dùng mã định danh dạng số trong cơ sở dữ liệu hoặc số điện thoại. Mã hóa mã định danh dự án theo quy tắc URL khi tạo yêu cầu.
Yêu cầu
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID/events"Phản hồi
Ví dụ phản hồi giả định.
{
"status": {
"code": 200,
"msg": "Project Events",
"results": 1
},
"response": [
{
"id": 31,
"subject": "Example project update",
"event": "{\"type\":\"comment\",\"value\":\"Example update\",\"source\":\"Example source\"}",
"type": "comment",
"value": "Example update",
"source": "Example source",
"date_created": "2026-10-23 12:00:00"
}
]
}Một dự án hiện có nhưng không có sự kiện sẽ trả về mã API 200, một danh sách rỗng và status.results bằng 0. Kết quả được yêu cầu theo thứ tự thời gian tạo giảm dần, không có tiêu chí sắp xếp bổ sung khi thời gian trùng nhau, không có phân trang, con trỏ hoặc bộ lọc ngày.
Đọc kỹ dữ liệu sự kiện
id là mã định danh dạng số của hàng sự kiện, subject là tiêu đề đã lưu của sự kiện, còn date_created là giá trị ngày/giờ đã lưu của sự kiện. Điểm cuối giữ nguyên chuỗi thô event và cũng cố gắng giải mã các thuộc tính của chuỗi này: type, value và source. Nếu dữ liệu không phải là một đối tượng JSON hoặc thiếu một thuộc tính, trường đã phân tích tương ứng sẽ là chuỗi rỗng.
Dữ liệu không phải là một tập giá trị liệt kê cố định và cũng không được bảo đảm tuân theo lược đồ văn bản thuần túy. Không coi văn bản nguồn là danh tính đã được xác minh hoặc hiển thị nội dung sự kiện dưới dạng HTML. Giữ các sự kiện thô trong những quy trình phía máy chủ được cấp quyền và chỉ hiển thị văn bản phù hợp cho người dùng được cấp quyền. Điểm cuối này không có bộ lọc riêng về khả năng hiển thị sự kiện cho nhân viên/khách hàng hoặc cơ chế che giấu nội dung.
Lịch sử không bảo đảm việc chuyển giao
Đây là lịch sử dự án đã lưu, không phải luồng thông báo webhook, con trỏ đồng bộ hóa bất biến hay bản ghi đầy đủ về mọi thay đổi trong cơ sở dữ liệu. Ví dụ, việc thêm số qua trình xử lý thêm số đã được rà soát tự nó không tạo ra sự kiện. Ngoài việc đọc các sự kiện, hãy đối soát cả danh sách số và số lượng theo từng trạng thái.
Lỗi và giới hạn
Kiểm tra cả phản hồi HTTP và status.code/status.msg. Nếu dự án không tồn tại, đã bị xóa hoặc không thuộc tài khoản, hệ thống trả về mã API 404 kèm thông báo không tìm thấy dự án. Các yêu cầu xác thực và hạn chế về địa chỉ IP nguồn cũng được áp dụng. Các ví dụ không gửi yêu cầu thực tế, và phản hồi thành công không phải là bằng chứng cho thấy nhà mạng đã chấp nhận hoặc hoàn tất việc chuyển mạng giữ số.
Tác động
Trình xử lý đã được rà soát đọc các sự kiện đã lưu và không thay đổi dự án, bắt đầu việc chuyển mạng giữ số hoặc ghi nợ tài khoản. Khả năng hiển thị của các thành phần ghi sự kiện và việc kiểm thử tài khoản có xác thực vẫn thuộc phạm vi rà soát hợp đồng giao tiếp đang chờ thực hiện.