Tài liệu API Trustmove
Chào mừng bạn đến với tài liệu API của Trustmove. Tài liệu này cung cấp thông tin về cách sử dụng API để theo dõi đơn hàng bằng tracking number và user.
API của chúng tôi cho phép bạn:
- Tra cứu thông tin đơn hàng theo tracking number
- Lấy danh sách đơn hàng theo username
Bắt đầu
Để sử dụng API của Trustmove, bạn cần:
- Đăng ký tài khoản với Trustmove
- Nhận thông tin xác thực API (nếu cần)
- Thực hiện các yêu cầu API đến các endpoint được mô tả dưới đây
Lưu ý: Tất cả các yêu cầu API nên được gửi đến domain chính của Trustmove: https://trustmove.vn
Xác thực (Dành cho đối tác - Liên hệ kỹ thuật để được cấp quyền)
Một số endpoint API dành cho đối tác yêu cầu xác thực. Chúng tôi sử dụng xác thực Bearer Token.
Để xác thực yêu cầu API, hãy thêm header sau vào yêu cầu của bạn:
Authorization: Bearer YOUR_TOKEN
Endpoints API
Tra cứu đơn hàng theo tracking number
GET
/api/tracking/{trackingNumber}
Trả về thông tin chi tiết về đơn hàng dựa trên tracking number.
Tham số đường dẫn:
| Tham số |
Mô tả |
Bắt buộc |
| trackingNumber |
Số tracking của đơn hàng |
Có |
Ví dụ yêu cầu:
GET /api/tracking/TM123456789
Ví dụ phản hồi:
{
"number": "TM123456789",
"status": "nhapkho",
"timestamp": "2023-06-15T08:30:00.000Z",
"warehouse_name": "Kho Hà Nội",
"warehouse_address": "123 Đường ABC, Hà Nội"
}
Mã trạng thái phản hồi:
| Mã |
Mô tả |
| 200 |
Thành công |
| 404 |
Không tìm thấy tracking number |
| 500 |
Lỗi server |
Lấy danh sách đơn hàng theo username
GET
/api/tracking/{username}
Trả về danh sách tất cả các đơn hàng của một user cụ thể.
Tham số đường dẫn:
| Tham số |
Mô tả |
Bắt buộc |
| username |
Tên người dùng |
Có |
Ví dụ yêu cầu:
GET /api/tracking/user123
Ví dụ phản hồi:
[
{
"number": "TM123456789",
"status": "nhapkho",
"timestamp": "2023-06-15T08:30:00.000Z",
"warehouse_name": "Kho Hà Nội",
"warehouse_address": "123 Đường ABC, Hà Nội"
},
{
"number": "TM987654321",
"status": "hoanthanh",
"timestamp": "2023-06-10T14:45:00.000Z",
"warehouse_name": "Kho Hồ Chí Minh",
"warehouse_address": "456 Đường XYZ, Hồ Chí Minh"
}
]
Mã trạng thái phản hồi:
| Mã |
Mô tả |
| 200 |
Thành công |
| 404 |
Không tìm thấy user |
| 500 |
Lỗi server |
Trạng thái đơn hàng
Đơn hàng có thể có một trong các trạng thái sau:
| Trạng thái |
Mô tả |
| nhapkho |
Đơn hàng đã được nhập kho |
| hoanthanh |
Đơn hàng đã hoàn thành giao hàng |
Ví dụ tích hợp
JavaScript (Fetch API)
// Tra cứu theo tracking number
async function checkTracking(trackingNumber) {
try {
const response = await fetch(`https://trustmove.vn/api/tracking/${trackingNumber}`);
if (response.ok) {
const data = await response.json();
console.log('Thông tin đơn hàng:', data);
return data;
} else {
console.error('Không tìm thấy thông tin tracking');
return null;
}
} catch (error) {
console.error('Lỗi khi tra cứu tracking:', error);
return null;
}
}
// Lấy danh sách đơn hàng theo username
async function getUserTracking(username) {
try {
const response = await fetch(`https://trustmove.vn/api/tracking/${username}`);
if (response.ok) {
const data = await response.json();
console.log('Danh sách đơn hàng:', data);
return data;
} else {
console.error('Không tìm thấy thông tin user');
return [];
}
} catch (error) {
console.error('Lỗi khi lấy danh sách đơn hàng:', error);
return [];
}
}
PHP
// Tra cứu theo tracking number
function checkTracking($trackingNumber) {
$url = "https://trustmove.vn/api/tracking/" . $trackingNumber;
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($httpCode == 200) {
return json_decode($response, true);
} else {
return null;
}
}
// Lấy danh sách đơn hàng theo username
function getUserTracking($username) {
$url = "https://trustmove.vn/api/tracking/" . $username;
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($httpCode == 200) {
return json_decode($response, true);
} else {
return [];
}
}
Hỗ trợ
Nếu bạn gặp bất kỳ vấn đề nào khi sử dụng API của chúng tôi, vui lòng liên hệ với đội ngũ hỗ trợ của Trustmove:
- Email: support@trustmove.vn
