API cho nhà phát triển: tích hợp dữ liệu sự kiện vào hệ thống riêng

Khi trang sự kiện của LibPix không phải là nơi khách cần dừng lại

Phần lớn ban tổ chức dùng trực tiếp trang sự kiện và luồng tìm ảnh có sẵn của LibPix — điều này phù hợp với đa số trường hợp. Nhưng nếu bạn đã có website hoặc ứng dụng riêng cho sự kiện của mình, và muốn khách tìm ảnh ngay trong chính giao diện đó mà không cần chuyển qua một trang khác, đây là lúc API cho nhà phát triển trở nên hữu ích.

API cung cấp những gì

API công khai của LibPix, truy cập qua tiền tố /api/v1/, cho phép lấy danh sách sự kiện, danh sách ảnh của một sự kiện, và thực hiện tìm ảnh bằng khuôn mặt — ba khả năng cốt lõi giống như những gì khách thấy trên trang sự kiện thông thường, nhưng ở dạng dữ liệu để bạn tự dựng giao diện theo ý mình. Xác thực được thực hiện qua một API key riêng, gửi kèm trong header X-API-Key của mỗi yêu cầu.

Gói nào có quyền dùng API

Quyền truy cập API chỉ dành cho hai gói thuê bao cao nhất: Bạch Kim và Kim Cương. Đây là lựa chọn có chủ đích — API phục vụ nhu cầu tích hợp kỹ thuật sâu hơn, thường đi kèm với quy mô sử dụng lớn hơn, nên được xếp cùng nhóm với các gói đã có nhiều sự kiện và dung lượng ảnh cao nhất. Các gói thấp hơn, bao gồm cả dòng đặt sự kiện trả một lần, không có quyền này.

API key được quản lý ở đâu

Nếu tài khoản của bạn thuộc gói có quyền API, bạn có thể tạo và quản lý API key ngay trong tab Bảo mật của trang quản lý tài khoản. Mỗi API key có tiền tố cố định để hệ thống nhận diện đúng định dạng, và chỉ hoạt động khi tài khoản đang active và gói chưa hết hạn — key không tự động vô hiệu khi gói hết hạn, nhưng mọi yêu cầu gửi tới sau thời điểm đó sẽ bị từ chối cho tới khi bạn gia hạn.

Vì sao gói hết hạn lại khoá API ngay, không có thời gian gia hạn mềm

Đây là một điểm khác biệt so với một số tính năng khác: API bị khoá ngay khi gói hết hạn, không có khoảng thời gian gia hạn mềm như một số cơ chế lưu trữ ảnh khác. Lý do là API thường được tích hợp vào một hệ thống đang vận hành — nếu để API tiếp tục hoạt động sau khi gói hết hạn, dễ tạo ra tình huống ban tổ chức trì hoãn gia hạn vô thời hạn vì hệ thống của họ vẫn chạy bình thường, trong khi đây vốn là một quyền lợi gắn chặt với gói cao cấp.

Ba khả năng, không phải một bộ công cụ quản lý đầy đủ

Cần hiểu đúng giới hạn của API hiện tại: nó cung cấp khả năng đọc dữ liệu sự kiện và tìm ảnh, không phải một bộ công cụ quản lý toàn diện để tạo sự kiện mới, chỉnh sửa cấu hình, hay quản lý thanh toán từ xa. Nếu bạn cần những thao tác quản lý đó, vẫn cần thực hiện qua giao diện quản lý sự kiện thông thường — API chỉ đóng vai trò là cửa đọc dữ liệu cho một giao diện khách hàng riêng của bạn.

Ai thực sự cần tới API

API phù hợp với các tổ chức có đội kỹ thuật riêng, đã có sẵn một nền tảng hoặc ứng dụng cho sự kiện của mình và muốn nhúng chức năng tìm ảnh vào đúng nơi khách đang tương tác — ví dụ một nền tảng giải chạy marathon có ứng dụng riêng cho người tham gia, muốn người chạy tìm ảnh ngay trong ứng dụng đó thay vì được dẫn ra một trang khác. Với phần lớn ban tổ chức sự kiện đơn lẻ hoặc không có đội kỹ thuật riêng, trang sự kiện có sẵn của LibPix vẫn là lựa chọn đơn giản và đủ dùng hơn nhiều so với việc tự xây giao diện riêng.

Một tình huống thực tế: nền tảng giải chạy có ứng dụng riêng

Hình dung một đơn vị tổ chức giải chạy marathon đã có ứng dụng di động riêng để người tham gia đăng ký, xem thành tích, và nhận thông báo. Nếu phải mở thêm một đường link riêng để tìm ảnh, một số người tham gia sẽ không biết tới hoặc quên mất đường link đó giữa rất nhiều thông báo khác. Tích hợp tìm ảnh bằng khuôn mặt thẳng vào đúng ứng dụng người tham gia đang dùng hằng ngày giúp tăng khả năng họ thực sự tìm và xem lại ảnh của mình, vì không cần rời khỏi nơi họ đã quen thuộc.

Dữ liệu trả về vẫn tuân theo các quy tắc an toàn chung

Dù truy cập qua API, dữ liệu ảnh trả về vẫn tuân theo các nguyên tắc chung của hệ thống — ví dụ ảnh của mỗi sự kiện vẫn được phân biệt rõ ràng với sự kiện khác, và các đường dẫn ảnh trả về là định danh do hệ thống quản lý, không phải đường link trực tiếp tới nguồn lưu trữ gốc. Việc dùng API không tạo ra một lối đi tắt vòng qua các lớp bảo vệ dữ liệu đã có.

API là công cụ cho đúng nhóm nhu cầu

API không phải tính năng mọi ban tổ chức cần dùng tới, nhưng với những đơn vị đã có nền tảng kỹ thuật riêng và cần tích hợp sâu, đây là cách để mang khả năng tìm ảnh bằng khuôn mặt của LibPix vào đúng nơi người dùng của họ đang ở, mà không cần xây dựng lại toàn bộ hệ thống AI nhận diện khuôn mặt từ đầu.

Nếu bạn muốn tìm hiểu thêm về gói có quyền API, có thể xem chi tiết tại /pricing, hoặc thử trải nghiệm luồng tìm ảnh cơ bản qua bản demo sự kiện mẫu trước khi quyết định tích hợp API vào hệ thống riêng của bạn.