Tài liệu REST API
REST API số điện thoại
Tìm các quốc gia và số khả dụng, xem toàn bộ nội dung gói dịch vụ, và quản lý các số bạn sở hữu.
Chọn API và thông tin xác thực cùng nhau
Các tài khoản Nhà phát triển & Tự động hóa, Doanh nghiệp và Nhà cung cấp truyền thông đã được phê duyệt có thể tích hợp các dịch vụ đã được bật. Một nhà phát triển cá nhân không cần phải giả danh là công ty. SMS/MMS ứng dụng yêu cầu phê duyệt gửi tin và đăng ký phù hợp. Dịch vụ Cá nhân & Gia đình không có API khởi tạo tin nhắn nào mà khách hàng có thể truy cập.
| Nhóm API | URL cơ sở | Xác thực và kết quả |
|---|---|---|
| Communications v3 | https://api.multitel.net/v3 | Thông tin xác thực Basic đã được phê duyệt; chỉ dùng token được cấp phát đủ điều kiện cho những thao tác có hỗ trợ. JSON status và response. |
| Đăng ký dịch vụ gọi khẩn cấp | https://api.multi.tel/emergency | Thông tin xác thực Basic đã được phê duyệt hoặc quyền truy cập bearer được cấp phát riêng. JSON code, message và data. |
| Tích hợp REST của cổng thông tin | Máy chủ và thao tác được hiển thị trong tài liệu tham chiếu dành cho nhà phát triển của tài khoản bạn | Hãy dùng thông tin xác thực, phạm vi quyền (scope) và lược đồ đã được ghi trong tài liệu của thao tác đó. Các yêu cầu từ phiên trình duyệt thuộc một giao diện riêng biệt. |
Hãy đặt MULTITEL_API_USERNAME và MULTITEL_API_PASSWORD thông qua cấu hình bí mật của máy chủ bạn trước khi dùng các ví dụ. Tuyệt đối không nhúng chúng vào JavaScript công khai trên trình duyệt, URL hoặc kho quản lý mã nguồn. Thông tin xác thực chuyên dụng được quản lý tại cài đặt tích hợp API.
Đọc danh mục quốc gia hiện có
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multitel.net/v3/getcountries"Phản hồi v3 chứa status và một mảng response. Các mục quốc gia bao gồm isocode, name, countrycode, thông tin về khả năng và next_function. Tình trạng sẵn có phụ thuộc vào tài khoản và kho số; việc một quốc gia xuất hiện không phải là cam kết rằng mọi tiền tố hay loại số đều còn hàng.
{
"status": {
"code": 200,
"msg": "Results: 1"
},
"response": [
{
"countrycode": "1",
"name": "United States",
"description": "United States",
"isocode": "US",
"is_mobile": 0,
"sms_coverage": 1,
"latitude": "37.0902",
"longitude": "-95.7129",
"next_function": "v3/getareas/US"
}
]
}Từ khám phá đến kích hoạt
- Chọn quốc gia, đơn vị hành chính cấp dưới khi được yêu cầu, khu vực và loại số bằng các thao tác địa lý tương ứng.
- Đọc giá thiết lập, giá hằng tháng và giá sử dụng, các kênh, hạn mức đi kèm và yêu cầu đăng ký của số đã chọn.
- Gửi các tài liệu người dùng cuối bắt buộc và xem lại trạng thái của chúng. Một số có thể ở trạng thái chờ cho đến khi được phê duyệt.
- Chỉ đặt hàng một lần với lựa chọn kho số/giá chính xác. Nếu phản hồi không chắc chắn, hãy kiểm tra kho số của bạn trước khi gửi một đơn hàng khác.
- Cấu hình định tuyến thoại và chuyển phát tin nhắn một cách độc lập, sau đó kiểm thử toàn bộ tuyến đường dự kiến.
Xử lý lỗi và thử lại
- Lỗi xác thực hoặc quyền truy cập
- Hãy kiểm tra trạng thái bật của thông tin xác thực API, dịch vụ được phép và giới hạn IP nguồn. Cookie phiên cổng thông tin không phải là thông tin xác thực tích hợp.
- Không đủ tín dụng hoặc chưa đáp ứng điều kiện phê duyệt
- Hãy giải quyết vấn đề số dư tài khoản, phê duyệt gửi tin hoặc yêu cầu về tài liệu trước khi lặp lại thao tác.
- Không có kết quả
- Hãy xử lý kho số trống hoặc không có tên người gọi như một kết quả bình thường. Đừng cho rằng một số hợp lệ về mặt cú pháp thì có đầy đủ mọi dịch vụ.
- Hết thời gian chờ mạng hoặc lỗi dịch vụ
- Với các thao tác đọc, hãy thử lại có giới hạn kèm backoff. Với thao tác mua, gửi hoặc đăng ký, hãy kiểm tra trạng thái thao tác trước; thử lại một yêu cầu đã được chấp nhận có thể tạo ra thao tác bị tính phí trùng lặp.
Khả năng hỗ trợ idempotency tùy thuộc vào từng nhóm API. Emergency API hỗ trợ khóa thử lại; điều đó không làm cho các yêu cầu v3 tùy ý trở nên idempotent. Hãy lưu lại dấu thời gian, ID được trả về và các phản hồi đã ẩn thông tin nhạy cảm để phục vụ hỗ trợ.
Tiếp tục với tài liệu tham chiếu dành cho tài khoản của bạn
Tài liệu tham chiếu sau khi đăng nhập lọc các thao tác theo quyền và các dịch vụ đã bật của bạn. Hãy dùng đúng máy chủ, loại thông tin xác thực, trường yêu cầu và lược đồ phản hồi được nêu trong đó. Các bảng điều khiển có thể thực thi thao tác thực, bao gồm mua hàng và gửi tin nhắn.