Quyền truy cập tài khoản và dự án
Sử dụng tài khoản API đã bật qua HTTPS từ địa chỉ IP được phép. Dự án phải thuộc tài khoản đó và chưa bị xóa. Dùng ID duy nhất của dự án từ quy trình đặt lệnh chuyển mạng, không dùng ID dạng số trong cơ sở dữ liệu hoặc số điện thoại. Mã hóa URL cho ID dự án 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/numbers"Phản hồi
Ví dụ phản hồi với dữ liệu giả định.
{
"status": {
"code": 200,
"msg": "Project Numbers",
"results": 1
},
"response": [
{
"id": 21,
"number": "12025550123",
"status": 0,
"status_str": "Pending",
"isocode": "US",
"updated": "2026-10-23 12:00:00",
"foc": "",
"comment": "Example customer-visible note",
"date_created": "2026-10-23 12:00:00",
"date_completed": ""
}
]
}response là một danh sách. Dự án hiện có nhưng không có số nào trả về danh sách rỗng với mã API 200 và status.results bằng 0. Ngược lại, dự án không tồn tại trả về mã API 404.
Các trường của số
| Trường | Ý nghĩa |
|---|---|
| id, number, isocode | ID dạng số của hàng, chuỗi số điện thoại đã lưu và mã quốc gia. ID của hàng không phải ID dự án. |
| status, status_str | Trạng thái dạng số và nhãn đã biết tương ứng. |
| foc | Giá trị lịch cam kết đơn hàng chính thức đã lưu. Giá trị này có thể trống; trình xử lý không chuyển đổi nó sang múi giờ hoặc định dạng dấu thời gian được tài liệu hóa. |
| updated, date_created, date_completed | Các giá trị cập nhật, tạo và hoàn tất đã lưu. Xử lý rõ ràng các giá trị trống; không mặc định là ISO8601 hoặc suy ra múi giờ từ ví dụ giả định. |
| comment | Ghi chú dành cho khách hàng đã lưu. Hiển thị dưới dạng văn bản, không phải HTML có thể thực thi. |
Cấu trúc phản hồi này bỏ qua trường chỉ dành cho nhân viên internal_comment. Điều này không có nghĩa là tra cứu một số riêng lẻ theo cách cũ sử dụng cùng cấu trúc phản hồi.
Sắp xếp và theo dõi
Truy vấn sắp xếp theo thời điểm tạo tăng dần. Các hàng có cùng thời điểm tạo không được bảo đảm thêm thứ tự nào khác. Không có phân trang, con trỏ tăng dần hoặc bộ lọc ngày. Đọc toàn bộ danh sách để đối soát dự án và không xem số hàng hiện tại là một danh mục cố định.
Hiểu trạng thái chuyển mạng
| Giá trị | Nhãn |
|---|---|
| 0 | Pending |
| 1 | In Progress |
| 2 | Completed |
| 9 | Rejected |
Giữ lại trạng thái dạng số và xử lý cả các giá trị chưa biết. Nhãn không xác định sẽ dùng giá trị đã lưu thay vì bảo đảm có nhãn mới. Trạng thái hoàn tất hoặc ngày dự kiến đã lưu tự nó không kiểm thử định tuyến cuộc gọi đến hay mọi dịch vụ trên số đó.
Lỗi và giới hạn
Kiểm tra cả phản hồi HTTP và status.code/status.msg. Dự án không tồn tại, đã xóa hoặc không thuộc tài khoản trả về mã API 404 kèm thông báo không tìm thấy dự án. Các hạn chế về xác thực và IP nguồn cũng á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 chứng minh nhà mạng đã chấp nhận hoặc hoàn tất việc chuyển số.
Tác động
Trình xử lý được xem xét chỉ đọc dự án và các hàng số đã lưu. Phản hồi là ảnh chụp trạng thái, không phải xác nhận của nhà mạng hoặc kiểm thử dịch vụ trực tiếp. Nó không bắt đầu chuyển mạng, thay đổi định tuyến hay trừ tiền tài khoản.