Kết nối API gửi nhận SMS

Giới Thiệu

API là cửa ngõ giao tiếp cho cho phép bạn tích hợp tính năng gửi tin nhắn vào trong ứng dụng của bạn và gửi tin nhắn qua hệ thống của vinams. Bạn có thể tích hợp SMS API vào Website, ứng dụng desktop, hay các ứng dụng di động. API tương thích với tất cả các ngôn ngữ lập trình phổ biến hiện nay như: C#, ASP.NET, PHP, Java. API đảm bảo tính nhanh, đơn giản, tin cậy và dễ dàng tích hợp vào bất kỳ hệ thống nào.

API Access Token

Để sử dụng API bạn cần phải đăng ký một tài khoản tại địa chỉ https://vinasms.com. Sau khi đăng nhập tài khoản bạn vào mục quản lý token để nhận token của mình. Token là một chuỗi bảo mật dài 128 ký tự nhằm đảm bảo an toàn thông tin trao đổi giữa 2 hệ thống. Sau khi có token bạn có thể test API bằng postman và sau đó nhúng vào trong ứng dụng của bạn theo hướng dẫn sau

Postman sample

Dưới đây là link, cách truyền tham số và token thông qua phần mềm test API postman. Chúng tôi khuyến nghị nên dùng postman web để được cập nhật đầy đủ và mới nhất:

Link

https://vinasms.com/api/sendsms

Request Header

Token:  xxxxxxxxxxxx

Query Params

Numbers:   Các số điện thoại nhận tin nhắn, cách nhau bởi dấu phảy (Ví dụ: 0989998888,0912229999...)
Messages: Nội dung tin nhắn ít hơn 160 ký tự

Code mẫu tích hợp API trong ứng dụng PHP

Dưới đây là đoạn mã để gọi API và gửi tin nhắn qua hệ thống vinasms sử dụng ngôn ngữ PHP và CURL

$data = ["numbers"=>"0989998888,0912229999", "message"=>"Hello world"];
$hearderAuth[] = "Content-Type: application/json";
$hearderAuth[] = "Accept: application/json";
$hearder[] = "Token: xxxxxxxxxxxx";
$url = "http://vinasms.com/api/sendsms";
$curl = curl_init($url);
curl_setopt($curl, CURLOPT_HTTPAUTH, CURLAUTH_ANY);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, $hearder);
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, 0);
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, 0);
curl_setopt($curl, CURLOPT_POSTFIELDS, $data);
$result = curl_exec($curl);
curl_close($curl);

Mã lỗi và cấu trúc dữ liệu trả về

Dữ liệu trả về có cấu trúc JSON và kèm theo các mã lỗi như sau
200: Gửi tin nhắn thành công
401: Token không hợp lệ
402: Số điện thoại không hợp lệ
403: Đã hết quota gửi tin (lỗi này xảy ra khi bạn đã gửi hết số tin nhắn trong gói, bạn cần mua bổ sung gói tin nhắn)
500: Lỗi truy cập máy chủ (thường xẩy ra do kết nối mạng không ổn định)

Tính năng báo cáo

Khi sử dụng dịch vụ SMS API bạn sẽ cần biết là tin nhắn có thực sự được gửi tới máy khách hàng hay không hoặc khách hàng đã nhận được tin nhắn hay chưa? Để kiểm tra thông tin này bạn có thể đăng nhập vào trang vinasms.com phần quản lý tin nhắn bạn sẽ xem được trạng thái tin nhắn, biết được các tin nhắn đã gửi thành công hay thất bại.

Các tin nhắn gửi thất bại sẽ không làm giảm trừ quota gửi tin nhắn của bạn, bạn nên kiểm tra lại số điện thoại người nhận và gửi lại tin nhắn để đảm bảo là tin nhắn được gửi thành công

Video hướng dẫn kết nối api gửi tin nhắn qua vinasms.com