Chỉ đặt đơn trên website
Bạn không cần tạo khóa API. Hãy tiếp tục đặt đơn như bình thường trên giao diện.
Đặt đơn trên websiteAPI dành cho tích hợp riêng
Kết nối hệ thống của bạn với quy trình đặt đơn.
Chỉ dùng API khi bạn có phần mềm hoặc đội kỹ thuật riêng. Nếu đặt đơn trực tiếp trên website, bạn không cần làm gì ở đây.
Một API keyDùng một khóa trong header Authorization.
Một đơn, một lần trừMã chống trùng cho yêu cầu tạo đơn.
Chỉ dùng VNDGiá và số dư API luôn là VND.
Trước khi bắt đầu
Bạn có cần dùng API không?
Phần này là lựa chọn bổ sung, không phải bước bắt buộc để sử dụng dịch vụ.
Có phần mềm hoặc đội kỹ thuật riêng
Kỹ thuật viên có thể dùng API để lấy dịch vụ, tạo đơn và kiểm tra trạng thái tự động.
Xem hướng dẫn kỹ thuật
01
Bắt đầu
Ba bước để gọi API đúng ngay từ đầu
Lưu khóa an toàn
Kích hoạt một API key rồi lưu nó trong khu vực bảo mật của phần mềm bạn.
Lấy mã dịch vụ
Gọi danh sách dịch vụ để chọn đúng mã trước khi tạo đơn.
Gửi đơn có mã chống trùng
Mỗi lần tạo đơn dùng một Idempotency-Key mới; nếu mạng lỗi, gửi lại đúng mã đó.
02
Khóa & bảo mật
Thông tin kết nối của bạn
Đang kiểm tra khóa...
Bạn chỉ cần một API key trong header Authorization.
API key chỉ hiện đầy đủ trong lần này. Hãy lưu nó trước khi rời trang.
Bắt buộc
Dùng trong header Authorization của mọi yêu cầu.
Giới hạn IP gọi API
Để trống nếu bạn không muốn giới hạn. Nếu có, chỉ các IP hoặc CIDR này mới gọi được API.
Giữ API key kín
Chỉ dùng trên máy chủ hoặc phần mềm của bạn; không đặt key vào URL hay mã chạy trên trình duyệt.
Không tạo đơn trùng
Tạo đơn luôn cần Idempotency-Key. Dùng lại cùng nội dung sẽ trả kết quả cũ, không trừ tiền thêm.
Giới hạn IP tùy chọn
Khi phần mềm có IP cố định, bạn có thể chỉ cho phép các IP đó gọi API.
03
Yêu cầu chính
Mẫu gọi an toàn để bạn bắt đầu
Base URL
/api/v2Xác thực
Authorization: Bearer {API_KEY}
Đơn vị tiền
VND
Ví dụ
04
Xử lý lỗi
Khi yêu cầu API chưa thành công
Đọc mã HTTP và mã lỗi trước khi thử lại. Đừng tạo đơn mới nếu bạn chưa chắc yêu cầu trước đã được xử lý.