Đặt mua số điện thoại theo đầu số

Đặt mua theo đầu số

Sử dụng thao tác này khi danh mục đầu số hướng dẫn bạn đặt mua một số lượng số điện thoại theo đầu số thay vì chọn từng số có sẵn. Bắt đầu với quốc gia, khu vực hoặc tiểu bang, rồi đến đầu số. Giữ mã định danh đầu số và gói cước lấy từ cùng một kết quả mới cập nhật. Đối với một số cụ thể được chọn từ danh sách số có sẵn, hãy sử dụng Mua số điện thoại đã chọn.

Yêu cầu này có thể mua số điện thoại và phát sinh phí. Đây không phải là yêu cầu báo giá, giữ chỗ hay chạy thử. Trước khi gửi, hãy xem xét phí thiết lập và phí hằng tháng, cước mỗi phút gọi đến, số phút đi kèm, số kênh, yêu cầu đăng ký và giới hạn mua của tài khoản. Kết quả từ danh mục không giữ số trong kho hay cố định giá. Việc kiểm tra nạp tiền vào tài khoản có thể diễn ra trước khi hoàn tất đơn hàng; bản thân một lỗi không chứng minh rằng chưa có giao dịch mua hoặc nạp tiền vào tài khoản nào xảy ra.

Gửi yêu cầu mua

Sử dụng tài khoản API đã được bật qua HTTPS từ địa chỉ IP nguồn được phép. Đặt các biến theo lựa chọn hiện tại của bạn trong danh mục và cấu hình chuyển cuộc gọi, tin nhắn đã được phê duyệt. Lệnh sau đây mua một số điện thoại.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --data-urlencode 'quantity=1' \
  --data-urlencode "price_id=$PRICE_ID" \
  --data-urlencode "channels=$CHANNELS" \
  --data-urlencode "reference=$ORDER_REFERENCE" \
  --data-urlencode "uri=$VOICE_URI" \
  "https://api.multitel.net/v3/order/$PREFIX_ID"

Ví dụ trên sử dụng POST với dữ liệu biểu mẫu. Bộ điều phối cũng đọc một đối tượng JSON khi Content-Type là application/json. Các trường JSON ghi đè các trường biểu mẫu/yêu cầu tương ứng. Sử dụng nhất quán một kiểu mã hóa; không gửi các giá trị mâu thuẫn giữa chuỗi truy vấn và phần thân yêu cầu.

Cài đặt chuyển cuộc gọi, tin nhắn và gia hạn

Chọn các cài đặt chuyển cuộc gọi và tin nhắn giống như khi bạn cấu hình số đó trên cổng quản lý. Đây là các giá trị cấu hình nâng cao, không phải hướng dẫn tạo tổng đài PBX được lưu trữ hoặc trung kế cho cuộc gọi đến. Sử dụng lại cấu hình tài khoản đã biết là hoạt động và kiểm tra số đã lưu sau khi mua. Chỉ riêng việc giao dịch mua được chấp nhận không xác minh rằng việc chuyển cuộc gọi hoặc SMS hoạt động.

Các trường này được chuẩn hóa và chuyển đến quy trình thanh toán, nhưng cách lưu lại khác nhau giữa các luồng xử lý kho số. Tuyến đặt hàng hiện tại không cung cấp các trường giới hạn báo giá nghiêm ngặt trong hướng dẫn mua số đã chọn như những biện pháp bảo vệ tương đương. Sử dụng quyền mua và giới hạn giá của tài khoản, đồng thời kiểm tra cấu hình số điện thoại sau khi mua.

Đọc toàn bộ kết quả

Phân tích phần thân JSON và kiểm tra status.code cùng status.msg ngay cả khi yêu cầu HTTP thành công. Tuyến này tự ghi phản hồi JSON của nó, và hàm hỗ trợ phản hồi dùng chung cũng không nhất thiết ánh xạ mã ứng dụng sang trạng thái HTTP. Mã ứng dụng có thể là số JSON hoặc chuỗi số. Không yêu cầu bắt buộc phải có status.results; trường này không xuất hiện trong kết quả đặt hàng thông thường.

{
  "status": {"code": "200", "msg": ""},
  "response": {
    "id": "o_fictional_example",
    "numbers": ["12025550123"],
    "price": {
      "per_minute": "0.01",
      "free_minutes": 0,
      "setup_price": "1.25",
      "monthly_price": "2.50",
      "channels": 2
    },
    "features": ["voice"],
    "needs_registration": 0,
    "restrictions": "",
    "registration_requirements": null
  }
}

Mã định danh, số điện thoại và các mức giá ở trên đều là giả định. Hãy coi ID đơn hàng là một mã không cần diễn giải cấu trúc bên trong. numbers liệt kê các số mà phản hồi này báo cáo là đã mua; hãy so sánh độ dài danh sách với số lượng bạn yêu cầu. Các khoản giá là chuỗi và phản hồi này làm tròn mức cước tiền tệ đến hai chữ số thập phân, bao gồm per_minute; sử dụng danh mục mới cập nhật để lấy độ chính xác ban đầu của mức cước. Số phút đi kèm và số kênh có thể được trả về dưới dạng giá trị số hoặc chuỗi số.

Khối giá mô tả gói đã chọn được dùng để tạo phản hồi, không phải hóa đơn chi tiết cho từng số hay tổng tiền của đơn hàng. Các số ứng viên trong kho có thể thuộc các gói khác nhau. Hãy đối soát từng số đã mua và các giao dịch tài khoản thay vì nhân các giá trị trong khối này rồi cho rằng chúng chứng minh tổng tiền cuối cùng.

Mua được một phần và kết quả chưa chắc chắn

Mã ứng dụng 200 có thể đi kèm cảnh báo và số lượng số điện thoại ít hơn yêu cầu. Lỗi xảy ra sau đó không hủy việc mua các số đã mua được. Lưu giữ ID đơn hàng, các số và thông báo được trả về. Đối soát các số đó trong kho của bạn và các giao dịch tài khoản trước khi quyết định có đặt mua số lượng còn thiếu hay không.

Hết thời gian chờ, yêu cầu bị ngắt kết nối, phản hồi sai định dạng hoặc lỗi sau khi gửi không phải là bằng chứng cho thấy chưa có gì xảy ra. Không tự động gửi yêu cầu mua khác, ngay cả khi dùng cùng mã tham chiếu. Lưu giữ yêu cầu ban đầu, mã tham chiếu và mọi ID đơn hàng được trả về, kiểm tra kho số và các giao dịch tài khoản, đồng thời liên hệ bộ phận hỗ trợ nếu kết quả vẫn chưa rõ.

Đơn hàng chưa được xác nhận có thể trả về mã ứng dụng 400 kèm nội dung cho biết đơn hàng vẫn đang được xác nhận. Lưu giữ ID đơn hàng được trả về và đối soát giao dịch mua đó; đây không phải là chỉ dẫn gửi lại yêu cầu. Cơ chế khôi phục đơn hàng đã ghi nhận theo dõi đơn hàng ban đầu trong nội bộ. Yêu cầu mới gửi đến thao tác này tạo một lần thử mua riêng biệt thay vì tiếp tục đơn hàng dựa trên mã tham chiếu của bạn, vì vậy có thể mua thêm số và tính thêm phí. Không sử dụng các yêu cầu mua lặp lại để kiểm tra trạng thái hoặc tìm kiếm kho số.

Đăng ký và kích hoạt

Số đã mua hoặc được cấp vẫn có thể cần đăng ký hoặc kích hoạt. Nếu needs_registration là 1, hãy kiểm tra restrictions và registration_requirements. Trường sau có thể chỉ ra v3/get_requirements cùng các giá trị country và number_type. Hoàn tất quy trình xác minh danh tính/địa chỉ phù hợp và xác nhận trạng thái của số trước khi dựa vào số đó để nhận cuộc gọi hoặc tin nhắn.

features mô tả các khả năng được công bố; trường này không xác minh việc định tuyến thực tế, phê duyệt chiến dịch, chuyển SMS hay nhận fax. Kiểm tra các cài đặt chuyển cuộc gọi và tin nhắn đã lưu, đồng thời thực hiện phép thử dịch vụ phù hợp khi số đã hoạt động.

Thông báo gọi lại về đơn hàng

Thông báo gọi lại gửi POST với dữ liệu JSON chứa trạng thái đơn hàng và phản hồi, đồng thời thêm mã tham chiếu của bạn nếu được cung cấp. Chúng được gửi cho các giao dịch mua được báo cáo, bao gồm cả kết quả mua được một phần. Thông báo gọi lại thất bại không hoàn tác giao dịch mua. Việc gửi có thể được thử lại, vì vậy hãy xử lý thông báo trùng lặp theo ID đơn hàng và đối soát các số thay vì gửi yêu cầu mua khác.

Tuyến này không thêm chữ ký mật mã cho thông báo gọi lại. Hãy coi thông báo gọi lại là thông báo để đối soát với kho số được truy cập qua xác thực của bạn, không phải sự cho phép độc lập để tính phí, cấp dịch vụ hoặc cấp quyền truy cập. Không đưa thông tin xác thực API vào URL gọi lại. Gửi yêu cầu mua khác với URL gọi lại khác không cập nhật đơn hàng ban đầu; việc đó tạo một lần thử mua riêng biệt. Giữ lại ID đơn hàng ban đầu khi yêu cầu bộ phận hỗ trợ điều tra thông báo gọi lại của đơn hàng đó.

Các lỗi cần xử lý