Đọc một bản ghi số điện thoại đã mua cùng cấu hình đã lưu của số đó. Thao tác này trả về một đối tượng thay vì mảng như điểm cuối inventory.
Yêu cầu
Sử dụng thông tin xác thực API ở phía máy chủ qua HTTPS. Các ví dụ đọc thông tin xác thực từ biến môi trường; chúng không chứa thông tin xác thực có thể sử dụng thực tế. Hãy kiểm tra status.code trong phần thân JSON cũng như trạng thái HTTP. Các trình xử lý cũ này không phải lúc nào cũng đặt trạng thái lỗi HTTP khi có lỗi ở cấp ứng dụng.
curl --user "$MULTITEL_API_USER:$MULTITEL_API_PASSWORD" \
"https://api.multitel.net/v3/numberinfo/12025550100"Đoạn đường dẫn bắt buộc là số điện thoại quốc tế đã lưu, không phải UUID của số đó hay số máy lẻ PBX. Trình xử lý này không sử dụng tham số truy vấn hoặc phần thân yêu cầu.
Phản hồi
Đây là cấu trúc phản hồi minh họa, không phải dữ liệu tài khoản hay báo giá hiện tại.
{
"status": {
"code": 200,
"msg": ""
},
"response": {
"number": "12025550100",
"uuid": "NUMBER_UUID",
"description": "Main reception",
"isocode": "US",
"config": {
"uri": "sip:reception@example.com",
"uri2": "",
"uri3": "",
"forward_destination": "",
"sms_uri": "",
"sms_forward_destination": ""
},
"features": {
"voice": "1",
"sms": "1",
"mms": "0"
},
"status": {
"capacity": {
"assigned_channels": "2",
"used_channels": "0",
"overflow": "0",
"overage_charge": "0.01"
},
"origination": {
"origination_trunk_id": "ORIGINATION_ID",
"origination_trunk_name": "ORIGINATION_NAME",
"origination_country_iso": "US",
"origination_continent_iso": "NA",
"origination_continent_name": "North America"
},
"service_active": "1",
"force_codec": "",
"force_dtmf": ""
},
"billing": {
"cnam": "0",
"overflow": "0",
"autorenew": "1",
"persistent": "0",
"date_created": "2026-01-01 00:00:00"
},
"price": {
"setup_price": "0.00",
"monthly_price": "1.00",
"per_minute": "0.01",
"free_minutes": "0",
"remaining_minutes": "0",
"perminute_charges": "0"
},
"needs_registration": "0",
"vrating": "",
"country_id": "COUNTRY_REFERENCE",
"area_id": "AREA_REFERENCE",
"provider_id": "OPAQUE_LEGACY_REFERENCE"
}
}| Trường | Ý nghĩa |
|---|---|
number, uuid, description, isocode | Số điện thoại, mã định danh số không mang ý nghĩa để diễn giải, mô tả và mã quốc gia đã lưu. |
config | Các trường đã lưu về đích nhận cuộc gọi thoại, chuyển tiếp ra bên ngoài, đích nhận SMS và chuyển tiếp SMS. Điểm cuối này không chỉnh sửa các trường đó. |
features | Các cờ khả năng thoại, SMS và MMS đã lưu. Không có gì bảo đảm các cờ được lưu theo cơ chế cũ là giá trị boolean trong JSON. |
status.capacity | Số kênh được cấp và đã sử dụng, thiết lập tràn kênh và mức phí vượt hạn mức đã lưu. Đây là siêu dữ liệu đã lưu, không phải báo giá dung lượng mới hay kết quả kiểm tra cuộc gọi trực tiếp. |
status.origination | Siêu dữ liệu đã lưu về nguồn vào của cuộc gọi. Hãy coi các mã định danh là những giá trị không mang ý nghĩa để diễn giải; không xây dựng logic ứng dụng dựa trên các tên nội bộ. |
status.service_active, force_codec, force_dtmf | Các trường cấu hình kích hoạt và phương tiện truyền thông đã lưu. Chỉ riêng một cờ không chứng minh rằng việc chuyển đến thành công. |
billing | Các giá trị đã lưu về CNAM, tràn kênh, gia hạn, duy trì và thời điểm tạo. Việc đọc các giá trị này không thay đổi thiết lập gia hạn hay các thiết lập thanh toán khác. |
price | Các mức giá thiết lập, hằng tháng, theo phút và hạn mức phút đã lưu. Trình xử lý không cung cấp trường tiền tệ hay báo giá mới. Không suy ra loại tiền tệ từ các giá trị mẫu hoặc sử dụng chúng làm báo giá mua hiện tại. |
So với inventory, điểm cuối này còn trả về needs_registration, vrating, country_id, area_id, provider_id và price.perminute_charges. Đây là các giá trị được lưu theo cơ chế cũ, không phải một phản hồi phê duyệt danh tính riêng biệt. Cần coi các mã tham chiếu là những giá trị không mang ý nghĩa để diễn giải; không tạo URL tra cứu hoặc suy ra các ánh xạ nhà cung cấp từ chúng khi chưa có phản hồi tra cứu phù hợp.
Không có số điện thoại khớp
Nếu không tìm thấy bản ghi khớp và chưa bị vô hiệu hóa cho tài khoản đã xác thực, phần thân JSON có status.code bằng 404 và một thông báo chứa number not found. Không dựa vào phần hậu tố chỉ dòng mã nguồn của thông báo. Hãy kiểm tra số điện thoại đã lưu và inventory trước khi thử lại.
Sử dụng kết quả
Đây là thao tác đọc dữ liệu đã lưu. Thao tác này không mua số điện thoại, phê duyệt giấy tờ xác minh danh tính, thay đổi đích nhận hoặc bảo đảm rằng cuộc gọi, fax hay tin nhắn sẽ được chuyển đến. Hãy kiểm tra riêng từng dịch vụ đã bật khi cấu hình số điện thoại.