API: cách phần mềm giao tiếp
API là giao diện để phần mềm tương tác theo một cách được quy định. Trong ví dụ này, hệ thống quản lý có thể gửi yêu cầu lấy thông tin một đơn hàng và nhận kết quả từ hệ thống bán hàng.
Với API qua HTTP, bạn thường cần biết địa chỉ nhận yêu cầu, phương thức, cách xác thực, dữ liệu gửi đi và dạng phản hồi. Tên trường và cách sử dụng cụ thể phải theo tài liệu của dịch vụ.
Webhook: nhận thông báo khi có sự kiện
Thay vì liên tục hỏi “có đơn mới chưa?”, bạn cung cấp một địa chỉ nhận thông báo. Khi xảy ra sự kiện được cấu hình, dịch vụ gửi thông tin đến địa chỉ đó.
Ví dụ: một đơn hàng được tạo, hệ thống gửi thông báo để quy trình tiếp nhận bắt đầu. Cơ chế gửi lại khi lỗi và dữ liệu kèm theo phụ thuộc dịch vụ.
JSON: một cách biểu diễn dữ liệu
JSON biểu diễn thông tin bằng các cặp tên và giá trị, danh sách cùng những kiểu dữ liệu cơ bản. Đây là dữ liệu giả lập của một đơn hàng:
{
"order_id": "DEMO-001",
"customer_name": "Khách mẫu",
"total": 250000,
"currency": "VND",
"paid": false,
"items": [
{ "name": "Sản phẩm mẫu", "quantity": 1 }
]
}
order_id là chuỗi ký tự; total là số; paid là giá trị đúng/sai; items là danh sách. Giữ đúng kiểu dữ liệu giúp các bước sau xử lý nhất quán.
Ghép lại thành một luồng
- Webhook báo có đơn mới.
- Quy trình đọc mã đơn từ dữ liệu nhận được.
- Nếu cần thêm thông tin, quy trình gọi API của hệ thống bán hàng.
- Kiểm tra dữ liệu và lưu một bản ghi vào bảng quản lý.
Một thông báo không luôn tương đương một lần xử lý: hệ thống có thể gửi lại khi chưa nhận được xác nhận. Thiết kế bước kiểm tra mã đơn để tránh tạo hai bản ghi cho cùng một đơn.
Bài tập của bạn
Đọc JSON phía trên và tìm mã đơn, số tiền, trạng thái thanh toán. Sau đó thêm một trường note là chuỗi và đổi paid thành true. Giải thích dữ liệu này sẽ đi qua những bước nào trong quy trình.
Trước khi kết nối dịch vụ thật, đọc tài liệu chính thức về xác thực, giới hạn yêu cầu và cách kiểm tra nguồn webhook. Không đặt khóa truy cập trong nội dung công khai hoặc tệp chia sẻ.