Xác nhận kho số di động đã được bật
Chỉ sử dụng tìm kiếm này sau khi kho số di động đã được bật cho tài khoản khách hàng của bạn. Lấy một tiền tố di động riêng lẻ hiện hành thông qua quy trình khám phá của tài khoản. Đường dẫn được hỗ trợ yêu cầu kho số không dây cho tiền tố đó. Nó không phụ thuộc vào một bản ghi siêu dữ liệu định tuyến hữu tuyến khớp tương ứng. Hãy liên hệ bộ phận hỗ trợ nếu bạn không chắc tài khoản hoặc tiền tố của mình đã được bật hay chưa.
Tuyến kế thừa hiện tại không từ chối một cách đáng tin cậy mọi yêu cầu không đủ điều kiện. Một tài khoản chưa bật kho số di động vẫn có thể nhận được kho số thông thường trong khi phản hồi vẫn ghi info.is_mobile: 1. Một tiền tố miễn cước cũng có thể đi tới nhánh kho số miễn cước kèm nhãn đó. Không sử dụng riêng nhãn này để nhận diện dịch vụ di động, và không gửi tiền tố thông thường hoặc miễn cước tới điểm cuối này. Hãy sử dụng danh mục di động đã được xác nhận và quy trình đã được bật của tài khoản.
Giữ mỗi số cùng với lựa chọn giá riêng của nó
Với mỗi ứng viên, hãy giữ number, info.uuid và danh sách price của cùng mục đó với nhau. Phản hồi cũng chứa siêu dữ liệu tiền tố/khu vực/quốc gia, điều khoản hợp đồng và các hạn chế đăng ký. Các ứng viên được sắp xếp theo giá hằng tháng của tùy chọn giá đầu tiên, theo thứ tự tăng dần; không có bảo đảm thứ tự ổn định cho các giá bằng nhau. Không thay thế ID số được trả về bằng ID khu vực hoặc ID tiền tố, và không ghép nó với ID giá của một ứng viên khác.
Phản hồi đầy đủ có thể bao gồm các trường siêu dữ liệu và giá bổ sung. Các giá trị features, giá trị kênh và restrictions được trả về mô tả ứng viên; chúng không phải là bảo đảm rằng cuộc gọi, SMS, MMS hoặc fax đã có thể sử dụng được. Quyền của tài khoản, việc đăng ký và gói dịch vụ đã chọn vẫn được áp dụng. Không coi các giá trị giữ chỗ trong ví dụ là ID hoặc giá hợp lệ.
Sử dụng một số lượng dương nhỏ
Hãy bắt đầu với số lượng là 1. Yêu cầu thông thường tới nhà cung cấp chuẩn hóa số lượng không dương thành 1 và giới hạn giá trị gửi lên ở mức 300, nhưng việc xử lý kết quả sau đó vẫn sử dụng giá trị nhập ban đầu. Do đó, số lượng bằng không có thể yêu cầu kho số từ nhà cung cấp và không trả về ứng viên nào. Các nhánh kế thừa khác không thực thi nhất quán số lượng kết quả được yêu cầu. Không dựa vào một mức tối đa chung duy nhất và không gửi giá trị âm, phân số hoặc không phải số. Không có bộ lọc tìm kiếm công khai được hỗ trợ hay tham số nội dung ID giá nào được ghi nhận cho tuyến này.
Phân biệt thiếu hàng tồn với lỗi tra cứu
Một phản hồi 404 có thể biểu thị kho số không khả dụng, dịch vụ bị tắt, tra cứu nhà cung ứng thất bại hoặc bản ghi danh mục không hợp lệ. Hãy coi việc hết thời gian chờ hoặc lỗi của nhà cung cấp là tình trạng khả dụng chưa xác định thay vì xác nhận đã hết hàng. Làm mới lựa chọn và thử lại với thời gian giãn cách tăng dần khi thích hợp. Tránh thăm dò lặp đi lặp lại từng tổng đài. Điểm cuối đếm kho số di động riêng biệt chỉ là một gợi ý tức thời và không nhất thiết phải khớp với độ dài danh sách ứng viên của tài khoản này.
Kiểm tra lại trước khi mua
Tìm kiếm không giữ chỗ hàng tồn. Nhánh đã được rà soát cố gắng loại trừ các số đã được mua, nhưng một lần tra cứu đặt chỗ cục bộ thất bại có thể để lại ứng viên như vậy trong kết quả. Tình trạng khả dụng, quyền sở hữu, giá đã được phê duyệt và việc đăng ký phải được quy trình mua kiểm tra. Hãy sử dụng một lựa chọn mới với yêu cầu mua có bảo vệ, và đối chiếu kho số của tài khoản sau bất kỳ kết quả mua không chắc chắn nào trước khi thử lại. Không bao giờ mua chỉ vì một ứng viên đã được trả về.
Yêu cầu
Sử dụng một tài khoản API đã được bật qua HTTPS từ một địa chỉ IP nguồn được phép. Kho số di động cũng phải được bật cho tài khoản khách hàng; chỉ riêng việc xác thực API không bật được nó.
GET với mã định danh tiền tố riêng lẻ hiện hành và một số lượng là số nguyên dương trong đường dẫn URL. Số lượng mặc định là 1 nếu bỏ qua. Hãy sử dụng ví dụ với 1; tuyến này không xác thực hoặc thực thi nhất quán một giới hạn kết quả chung.
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getmobiles/$PREFIX_ID/1"| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
prefix_id | string | Có | ID hiển thị (coi là giá trị định danh nguyên dạng, không suy diễn cấu trúc bên trong) của một tiền tố di động riêng lẻ đủ điều kiện lấy từ quy trình khám phá. Hãy sử dụng tiền tố tổng đài NPA/NXX di động được tài khoản của bạn hỗ trợ; không thay thế bằng ID khu vực, ID hiển thị theo nhóm, tiền tố quay số theo nghĩa đen hoặc tiền tố miễn cước. |
quantity | integer | Không | Số lượng ứng viên được yêu cầu. Mặc định là 1. Hãy cung cấp một số nguyên dương vừa phải. Yêu cầu thông thường gửi lên giới hạn số lượng của nó ở mức 300, nhưng đó không phải là một đầu vào được xác thực chung hay bảo đảm về kích thước phản hồi. |
Phản hồi
Hãy kiểm tra status.code và status.msg trong nội dung JSON cũng như trạng thái HTTP. Khi thành công, response là danh sách các ứng viên số, status.msg là Results: theo sau là số lượng được trả về, và status.results là độ dài danh sách đã tuần tự hóa. Giá của ứng viên là riêng theo từng tài khoản. Ví dụ minh họa rút gọn sử dụng các giá trị giữ chỗ thay cho kho số thực hay báo giá cước. Các số chứa mã quốc gia mà không có dấu cộng; các mã định danh là chuỗi được dùng nguyên dạng, không suy diễn cấu trúc bên trong.
Hình dạng phản hồi minh họa; không phải dữ liệu tài khoản thực hay báo giá hiện hành.
{
"status": {
"code": 200,
"msg": "Results: 1",
"results": 1
},
"response": [
{
"number": "12025550123",
"info": {
"uuid": "NUMBER_ID",
"prefix_uuid": "PREFIX_ID",
"country_iso": "US",
"is_mobile": 1
},
"price": [
{
"uuid": "PRICE_ID",
"monthly_price": "ACCOUNT_MONTHLY_PRICE",
"setup_price": "ACCOUNT_SETUP_PRICE",
"per_minute": "ACCOUNT_INCOMING_RATE",
"channels": "PLAN_CHANNELS"
}
],
"features": [
"voice",
"sms",
"mms",
"t38"
]
}
]
}Lỗi
- 404: ID tiền tố, quốc gia hoặc khu vực không hợp lệ: hãy làm mới lựa chọn tiền tố di động riêng lẻ.
- 404: Không tìm thấy số nào: có thể có nghĩa là không có hàng tồn khả dụng, dịch vụ bị tắt, tra cứu nhà cung cấp thất bại, lựa chọn không được hỗ trợ hoặc giới hạn của tài khoản. Đó không phải là bằng chứng có tính thẩm quyền về việc số lượng kho bằng không.
Tình trạng khả dụng và tác dụng phụ
- Tìm kiếm không thuê hay giữ chỗ số nào và đường dẫn đã được rà soát không trừ khoản tiền mua. Nó liên hệ với nhà cung cấp kho số và có thể mất thời gian.
- Các lần tìm kiếm thành công ghi các mục bộ nhớ đệm về số và giá liên quan đến tài khoản cùng nhật ký truy vấn. Lặp lại một lần tìm kiếm không phải là đặt chỗ, khóa giá hay mua.
- Giá, điều khoản, hạn chế và khả năng được trả về phải được xem xét cho tài khoản và số đã chọn. Một nhãn tính năng không xác lập việc kích hoạt, phê duyệt nhắn tin hay chức năng dịch vụ đã được kiểm thử.