1. Tổng quan
Bài viết này hướng dẫn anh/chị cách tạo và lấy thông tin API Key cùng API Secret trên hệ thống Omisell. Đây là các mã định danh quan trọng dùng để kết nối và đồng bộ dữ liệu giữa Omisell với các ứng dụng bên thứ ba (như MISA eShop) để tự động hóa quy trình quản lý đơn hàng và vận chuyển.
Nội dung tổng quan gồm:
- Truy cập mục Tích hợp API.
- Tạo mới API Key với các thiết lập về thời hạn và kích hoạt.
- Lưu trữ mã API Key và API Secret.
Đối tượng áp dụng: Quản trị viên cửa hàng trên Omisell.
2. Hướng dẫn thực hiện
2.1. Truy cập mục Tích hợp API
Để bắt đầu quá trình thiết lập kết nối, anh/chị cần đi đến khu vực quản lý ứng dụng.
- Bước 1: Tại giao diện chính Omisell, anh/chị nhấn vào biểu tượng [Tên cửa hàng/Tài khoản] ở góc dưới cùng bên trái màn hình.
- Bước 2: Trong danh sách menu hiện ra, anh/chị chọn mục [Tích hợp API].
2.2. Tạo mới API Key
Sau khi vào mục Tích hợp API, anh/chị tiến hành khởi tạo mã kết nối mới.
- Bước 1: Tại mục Quản lý API key, anh/chị nhấn vào nút [+ Thêm API key] để mở cửa sổ thiết lập.
- Bước 2: Tại cửa sổ Create new API Key, anh/chị thực hiện các thông tin sau:
- Tên API Key: Nhập tên để dễ dàng quản lý (ví dụ: Agentwork).
- Thời hạn: Chọn thời gian sử dụng mã (ví dụ: 90 ngày).
- Kích hoạt: Gạt thanh trạng thái sang màu xanh tại mục [Kích hoạt API key sau khi tạo] để mã có hiệu lực ngay lập tức.
- Bước 3: Nhấn nút [Tạo khóa] để hệ thống khởi tạo mã.
2.3. Lưu trữ API Key và API Secret
Lưu ý quan trọng: Mã API Secret chỉ hiển thị duy nhất một lần ngay sau khi tạo. Nếu anh/chị đóng cửa sổ mà chưa lưu, anh/chị sẽ không thể xem lại mã này.
- Bước 1: Khi cửa sổ Save your API Key and Secret hiển thị, anh/chị nhấn nút [Sao chép] tại dòng API Key để lưu mã.
- Bước 2: Nhấn nút [Sao chép] tại dòng API Secret để lưu mã.
- Mẹo: Anh/chị có thể nhấn nút [Copy both] để sao chép cả hai mã cùng lúc, giúp thao tác nhanh chóng và chính xác hơn.
- Bước 3: Sau khi đã lưu mã vào một nơi an toàn (như file ghi chú hoặc trình quản lý mật khẩu), nhấn [I have saved it] để hoàn tất.
3. Lưu ý
- Tính bảo mật: API Key và API Secret đóng vai trò như mật khẩu truy cập dữ liệu của cửa hàng. Anh/chị tuyệt đối không chia sẻ các mã này cho bên thứ ba không liên quan để tránh rủi ro bị đánh cắp dữ liệu kinh doanh.
- Mất mã Secret: Nếu anh/chị lỡ tay đóng cửa sổ mà chưa kịp lưu API Secret, anh/chị không thể lấy lại mã cũ. Khi đó, anh/chị cần xóa API Key hiện tại và thực hiện tạo lại một mã mới.
- Quản lý danh sách IP: Để tăng cường bảo mật, anh/chị nên nhập các địa chỉ IP được phép truy cập vào mục [Danh sách IP cho phép] ngay phía trên mục quản lý API key.