Phân tích chính xác nội dung tin nhắn
Tính kiểu mã hóa, độ dài sau mã hóa và số phân đoạn SMS cho nội dung bạn định gửi. Điểm cuối này không gửi SMS, giữ trước tuyến gửi hay trả về báo giá cước gửi. Hãy cung cấp toàn bộ nội dung cuối cùng, bao gồm mọi phần chân tin nhắn, liên kết hoặc hướng dẫn từ chối nhận tin mà quy trình gửi của bạn thêm vào.
Yêu cầu
Xác thực bằng tài khoản API đã được kích hoạt của bạn và địa chỉ IP nguồn được phép của tài khoản đó. Lưu thông tin xác thực trong kho lưu trữ bí mật phía máy chủ. Gửi một chuỗi UTF-8 trong trường text; ví dụ sử dụng các biến môi trường.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
--data-urlencode 'text=Your message here' \
https://api.multitel.net/v3/smslengthHỗ trợ dữ liệu đầu vào được mã hóa theo định dạng biểu mẫu. Một đối tượng JSON như {"text":"Your message here"} cũng được chấp nhận khi không cung cấp trường biểu mẫu hoặc trường truy vấn nào. Nên dùng POST để nội dung tin nhắn không xuất hiện trong URL. Nếu có cả dữ liệu đầu vào từ biểu mẫu và truy vấn, dữ liệu biểu mẫu sẽ được sử dụng. Không kết hợp các định dạng yêu cầu.
Phản hồi
{
"status": {
"code": "200",
"msg": ""
},
"response": {
"charset": 0,
"encoding": "GSM-7",
"count": 1,
"parts": 1,
"chars": 17,
"units": 17,
"single_limit": 160,
"multipart_limit": 153
}
}| Trường | Ý nghĩa |
|---|---|
| charset | 0 cho GSM-7 hoặc 2 cho UTF-16. |
| encoding | GSM-7 hoặc UTF-16. |
| parts, count | Hai tên gọi cho số phân đoạn SMS được tính toán. Cả hai đều bằng không khi nội dung rỗng. |
| units, chars | Hai tên gọi cho số đơn vị mã hóa. Các giá trị này không nhất thiết bằng số ký tự hiển thị. |
| single_limit | Giới hạn số đơn vị mã hóa cho một phân đoạn đơn với kiểu mã hóa đã chọn. |
| multipart_limit | Giới hạn số đơn vị mã hóa áp dụng cho mỗi phân đoạn sau khi trừ phần dung lượng dành cho thông tin ghép nối. |
Kiểu mã hóa và giới hạn phân đoạn
| Kiểu mã hóa | Phân đoạn đơn | Phân đoạn trong tin nhắn nhiều phần |
|---|---|---|
| GSM-7 | 160 đơn vị septet | 153 đơn vị septet |
| UTF-16 | 70 đơn vị mã | 67 đơn vị mã |
Các ký tự mở rộng của GSM-7 như ^, dấu ngoặc nhọn, dấu ngoặc vuông, dấu gạch chéo ngược, dấu gạch đứng, dấu ngã và ký hiệu euro chiếm hai đơn vị septet. Một ký tự nằm ngoài GSM-7 sẽ khiến toàn bộ tin nhắn chuyển sang cách đếm theo UTF-16. Một biểu tượng cảm xúc nằm ngoài mặt phẳng đa ngôn ngữ cơ bản sử dụng hai đơn vị UTF-16; một chuỗi biểu tượng cảm xúc hiển thị có thể chứa nhiều điểm mã.
Ví dụ, 160 chữ cái GSM-7 thông thường vừa trong một phân đoạn, còn 161 chữ cái cần hai phân đoạn. Tám mươi ký tự ^ sử dụng 160 đơn vị và vừa trong một phân đoạn; tám mươi mốt ký tự sử dụng 162 đơn vị và cần hai phân đoạn. Ba mươi lăm biểu tượng cảm xúc đơn giản nằm ngoài mặt phẳng đa ngôn ngữ cơ bản (BMP) sử dụng 70 đơn vị UTF-16 và vừa trong một phân đoạn; ba mươi sáu biểu tượng sử dụng 72 đơn vị và cần hai phân đoạn. Các dấu kết hợp và biểu tượng cảm xúc được nối với nhau có thể làm thay đổi những số lượng này.
Lỗi và nội dung rỗng
Nếu thiếu trường text, cung cấp một mảng hoặc đối tượng thay vì giá trị vô hướng, hoặc dữ liệu UTF-8 không hợp lệ, API sẽ trả về mã 403. Hãy đọc các trường JSON status.code và status.msg cùng với trạng thái HTTP; điểm cuối này trả về mã dưới dạng chuỗi. Chuỗi rỗng là hợp lệ và trả về số đơn vị bằng không và số phân đoạn bằng không.
Sử dụng kết quả trước khi gửi
Công cụ tính đã được rà soát không thực hiện thao tác gửi tin nhắn, gọi đến nhà mạng hay trừ tiền tài khoản. Kết quả của công cụ là bản phân tích nội dung đã cung cấp, không phải cam kết gửi thành công hay hóa đơn cuối cùng. Khi gửi, có thể áp dụng cước theo đích đến, phí nhà mạng, yêu cầu của chiến dịch và các thay đổi bổ sung đối với nội dung. Hãy tính lại sau khi thay đổi tin nhắn, sau đó sử dụng quy trình gửi đã được phê duyệt và mức giá hiện hành của tài khoản.