API công khai — Checkgo
Các endpoint đọc/ghi công khai (không cần xác thực) phục vụ tra cứu truy xuất nguồn gốc sản phẩm qua QR/GTIN, và các form công khai trên trang doanh nghiệp/sản phẩm.
| Method | Path | Mô tả |
|---|---|---|
| GET | https://api.checkgo.vn/health | Health check của API. Trả 200 khi service còn sống. |
| GET | https://api.checkgo.vn/api/dl/{gtin} | GS1 Digital Link resolver. Nhận GTIN (+ tuỳ chọn lô "10", serial "21") → dữ liệu sản phẩm/tem. Xem thêm bản HTML tại /01/{gtin}[/10/{lot}][/21/{serial}] trên site. |
| GET | https://api.checkgo.vn/api/qr/{code} | Tra cứu dữ liệu QR: join sản phẩm + lô + doanh nghiệp theo mã tem. |
| POST | https://api.checkgo.vn/api/qr/{code}/scan | Ghi nhận một lượt quét (kèm GPS tuỳ chọn nếu trình duyệt cho phép). |
| GET | https://api.checkgo.vn/api/businesses/{slug}/landing | Dữ liệu trang thương hiệu (landing) công khai của doanh nghiệp. |
| GET | https://api.checkgo.vn/api/businesses/{slug}/products/{productSlug} | Chi tiết một sản phẩm công khai theo slug. |
| GET | https://api.checkgo.vn/api/businesses/{slug}/reviews | Đánh giá công khai của khách hàng cho doanh nghiệp. |
| GET | https://api.checkgo.vn/api/products/{id}/reviews | Đánh giá công khai cho một sản phẩm cụ thể. |
| GET | https://api.checkgo.vn/api/certificate/{code} | Xác thực chứng nhận (certificate) gắn với một mã QR/tem. |
| GET | https://api.checkgo.vn/api/businesses/{slug}/articles | Danh sách bài viết công khai của doanh nghiệp. |
| GET | https://api.checkgo.vn/api/businesses/{slug}/articles/{articleSlug} | Chi tiết một bài viết công khai. |
Ngoài các endpoint đọc ở trên, một số route POST công khai khác (liên hệ, mua hàng, đánh giá,
kích hoạt bảo hành Checkgo Care…) phục vụ trực tiếp các form trên trang sản phẩm/doanh nghiệp — không phải
API tổng quát cho bên thứ ba tích hợp, nên không liệt kê tại đây. API xác thực (/api/auth/*)
và API quản trị (/api/admin/*) là nội bộ cho các ứng dụng quản trị của Checkgo, cần đăng nhập
và không dành cho agent/bên ngoài.