Tạo Ứng Dụng Riêng Tư với SHOPLINE Develop Apps

Phát triển Ứng dụng là một khung ứng dụng được tạo ra riêng cho cửa hàng SHOPLINE của bạn, do bạn hoặc nhà phát triển bên ngoài thực hiện. Khác với các ứng dụng công khai được thiết kế cho nhiều cửa hàng, Phát triển Ứng dụng là riêng tư và được tùy chỉnh theo nhu cầu độc đáo của cửa hàng bạn.

Với Phát triển Ứng dụng, bạn có thể truy cập dữ liệu cửa hàng một cách an toàn thông qua SHOPLINE Admin API hoặc mở rộng khả năng của cửa hàng ra các nền tảng bên ngoài bằng cách sử dụng Storefront API. Mỗi ứng dụng đi kèm với API Key và App Secret riêng, dùng để nhận diện ứng dụng của bạn, cũng như token truy cập API cho phép các yêu cầu API dựa trên quyền bạn cấu hình.

Bằng cách tạo và quản lý các thông tin xác thực API này, bạn có thể tích hợp dữ liệu SHOPLINE vào hệ thống nội bộ, tự động hóa quy trình làm việc hoặc xây dựng các tính năng tùy chỉnh hỗ trợ hoạt động kinh doanh. Nếu bạn dự định phát triển một ứng dụng tùy chỉnh — độc lập hoặc với sự hỗ trợ của các nhà phát triển — để đáp ứng các yêu cầu kinh doanh ngày càng tăng, Phát triển Ứng dụng cung cấp sự linh hoạt và kiểm soát cần thiết để thực hiện một cách an toàn.

Cấu hình Quyền Quản lý Ứng dụng

Trước khi tạo ứng dụng riêng tư, hãy đảm bảo bạn có quyền Quản lý Ứng dụng Riêng tư. Quản lý cửa hàng tự động có quyền truy cập phát triển ứng dụng đầy đủ.

Là quản lý cửa hàng, bạn có thể cấp quyền phát triển ứng dụng cho nhân viên, như xem hoặc chỉnh sửa ứng dụng riêng tư.

Để thiết lập quyền cho nhân viên:

1. Tìm nhân viên bạn muốn cấp quyền, và nhấp vào biểu tượng bút chì trong cột Hành động.

2. Dưới Quản lý quyền, đánh dấu chọn Quản lý ứng dụng riêng tư và nhấp Cập nhật để lưu.

   

Tạo Ứng dụng

Đăng nhập vào quản trị SHOPLINE > Ứng dụng > Phát triển Ứng dụng ở góc trên bên phải.

Đọc và đánh dấu vào ô nếu bạn đồng ý với 《Quyền API và điều khoản》 sử dụng, sau đó nhấp vào Bật phát triển.

Nhấp vào Tạo Ứng Dụng và nhập Tên ứng dụng, Nhà phát triển ứng dụng, và Địa chỉ email liên hệ của ứng dụng, sau đó nhấp vào Tạo Ứng Dụng.

Cấu hình Quyền API Quản trị

Nhấp vào Chỉnh sửa > tab Cấu hình quyền > nút Cấu hình của tùy chọn Tích hợp API Quản trị.

Nhập Phạm vi truy cập API Quản trị và thiết lập phạm vi truy cập, tạo một Webhook, rồi nhấn Lưu.

Cấu hình Quyền truy cập API Cửa hàng

Nhấp Chỉnh sửa để vào trang chi tiết ứng dụng, chọn tab Cấu hình quyền, và nhấp Cấu hình cho Tích hợp API cửa hàng.

Vào trang chỉnh sửa quyền API cửa hàng, đánh dấu chọn các tùy chọn thiết lập quyền truy cập API, và nhấp Lưu.

Truy cập Khóa API và Tạo Mã Token API

Để truy cập thông tin xác thực API của bạn, hãy vào tab Chứng chỉ API. Trang này hiển thị chứng chỉ API và các mã token truy cập được tạo dựa trên cấu hình quyền của bạn.

Chứng chỉ API

Dưới tab Chứng chỉ API, bạn sẽ tìm thấy hai thông tin xác thực quan trọng trong phần Chứng chỉ API:

• Khóa API: Mã định danh duy nhất cho ứng dụng của bạn.

• Bí mật ứng dụng: Khóa riêng dùng để ký bảo mật các yêu cầu API.

Các giá trị này được tạo tự động khi ứng dụng được tạo. Bí mật ứng dụng được ẩn để bảo mật và có thể sao chép khi cần.

Tạo Mã Token Truy cập API

Sau khi cấu hình quyền Admin API và/hoặc Storefront API, hãy vào Chứng chỉ API > Token truy cập và nhấp vào Cài đặt Ứng dụng để tạo token truy cập API.

• Token truy cập Admin API

  • Yêu cầu xác thực để xem hoặc làm mới.

  • Có hiệu lực trong 3 năm sau khi tạo.

  • Cho phép truy cập các điểm cuối API cấp quản trị.

• Token truy cập Store API

  • Có thể sao chép trực tiếp mà không cần xác thực thêm.

  • Dùng cho các tương tác API cấp cửa hàng.

Các token này cho phép giao tiếp an toàn với dịch vụ SHOPLINE và phải được giữ bí mật. Nếu ứng dụng bị gỡ cài đặt hoặc cài đặt lại, các token đã cấp trước đó có thể trở nên không hợp lệ và cần được tạo lại.

Cài đặt Ứng dụng

Trong tab Cài đặt Ứng dụng, bạn có thể thay đổi tên ứng dụng, thông tin nhà phát triển và mô tả.

Bạn cũng có thể chuyển một ứng dụng riêng tư thành Kênh Bán hàng. Sau khi chuyển đổi, ứng dụng riêng tư có thể sử dụng các tính năng kênh bán hàng, chẳng hạn như sử dụng Storefront API để lấy thông tin sản phẩm. Để biết thêm chi tiết, vui lòng tham khảo tài liệu dành cho nhà phát triển.

Xem Nhật ký Hoạt động

Chuyển sang Nhật ký hoạt động để xem tất cả các sự kiện hoạt động.

Gỡ cài đặt Ứng dụng

Nhấn Gỡ cài đặt Ứng dụng. Sau khi gỡ cài đặt, token truy cập API sẽ bị thu hồi, và ứng dụng sẽ không còn quyền truy cập dữ liệu cửa hàng qua Open API.

Xóa Ứng dụng Phát triển

Quay lại trang chính Phát triển Ứng dụng, nhấn Xóa để xóa ứng dụng đã chọn. Dữ liệu ứng dụng sẽ được xóa, và token truy cập API sẽ bị thu hồi. Ứng dụng sẽ không còn quyền truy cập dữ liệu cửa hàng qua Open API.