1. Public API
DATA SPORT
  • DATABASE-SPORT
    • Tổng quan
    • Logic
      • Logic tổng thể
    • Projects
      • Yêu cầu hệ thống
      • Architecture
        • Database
    • Public APi
      • Tổng quan
    • Cron Make File
      • Tổng quan
  • GOLANG-THESPORT
    • Tổng quan
    • Architecture
      • System
      • Database
      • Source Code
    • Development
      • Local
      • Production
  • GOLANG-KSPORT
    • Tổng quan
    • Architecture
      • System
      • Database
      • Source Code
    • Development
      • Production
  • CRONJOB-LARAVEL
    • Tổng quan
    • Logic
      • Logic tổng thể
    • Projects
      • Yêu cầu hệ thống
      • Architecture
        • System
        • Source code
        • Database
      • Development
        • Dev
        • Production
      • Public API
        • Common API
          • League & Cup Profile (Basic)
          • Schedule & Results (Basic)
          • Match Modify Record
          • List of Countries
          • List of Bookmakers
          • Configuration instructions
        • Live animation
          • Configuration instructions
          • Schedule & Results
        • Live Data
          • Livescores for Today
          • Livescores Changes
          • Schedule & Results
          • Schedule Changes
          • Events
          • Stats
          • Corner
          • Lineups
          • Injury
          • Match List of Live Text
          • Live Text
          • Transfer
        • Profile
          • League & Cup Profile
          • Subleague Profile
          • Cup Stage Profile
          • Team Profile
          • Team Profile Copy
          • Team Profile for Search
          • Player Profile
          • Player Profile for Search
          • Referee Profile
          • Teamlist with Player Profile
        • Stats
          • Matches Analysis
          • List of Player Stats (Match)
          • Player Stats (Match)
          • List of Player Stats (League & Cup)
          • Player Stats (League & Cup)
          • League Standing (Get Subleague)
          • League Standing
          • Cup Standing
          • Top Scorer
          • FIFA Ranking
        • Odds (18 bookmakers)
          • Pre-match and In-play Odds (Main)
          • Live Odds Changes (Main)
          • Historical Odds (Main)
          • Future Odds (Main)
          • Pre-match and In-play Odds (All)
          • Live Odds Changes (All)
          • Historical Odds (All)
          • Future Odds (All)
          • European Odds (Halftime)
          • In-play Odds
          • In-play Odds (Halftime)
          • Odd Modify Record
        • European Odds (200+ Bookmakers)
          • European Odds (200+ Bookmakers)
        • Other Odds
          • Outrights
          • First/Last Team To Score (pre-match)
          • Goals Odd/Even (pre-match)
          • Goals Odd/Even (In-play)
          • Number of Goals in Match (pre-match)
          • Number of Goals in Match (In-play)
          • Half Time/Full Time (pre-match)
          • Half Time/Full Time (In-play)
          • Correct Score (pre-match)
          • Correct Score (In-play)
          • Half Time Correct Score (pre-match)
          • Half Time Correct Score (In-play)
          • Handicap Corners (pre-match)
          • Handicap Corners (In-play)
          • Total Corners (pre-match) - Tổng phạt góc trước trận đấu: First Odds
          • Total Corners (In-play) - Tổng số quả phạt góc (Trong trận) - Run Odds
          • Double Chance(pre-match)
          • EuroHandicap(pre-match)
  • GOLANG-WEBSOCKET
    • Tổng Quan
    • Logic
      • Logic tổng thể
    • Projects
      • Yêu cầu hệ thống
      • Architecture
        • System
        • Source code
      • Development
        • Dev
        • Production
      • Public API
        • API
  • ADMIN-BANNER
    • Tổng quan
    • Logic
      • Logic tổng thể
    • Projects
      • Architecture
        • System
        • Source Code
      • Development
        • Develop
        • Production
      • Public API
        • API
      • Database
        • Cấu trúc Database
      • Admin FE
        • HƯỚNG DẪN CÀI ĐẶT MÔI TRƯỜNG DỰ ÁN SPORT ADMIN
        • Hướng dẫn Đăng nhập
        • QUẢN LÝ SITE (SITE MANAGEMENT)
        • QUẢN LÝ GIẢI ĐẤU (LEAGUE MANAGEMENT)
        • QUẢN LÝ NHÀ CUNG CẤP (SUPPLIER MANAGEMENT)
        • TIP & CHUYÊN GIA - TAB QUẢN LÝ TIPS (TIPS MANAGEMENT)
        • WHITELIST
        • QUẢN LÝ MINIGAME (MINIGAME MANAGEMENT)
        • TRAFFIC REPORT
        • TOOLS - RAPID DATA
        • TOOLS - LIVE SITES
        • TOOLS - SUPPLIERS
        • THEME / PLUGIN
        • NGƯỜI DÙNG - PHÂN QUYỀN VÀ HIỂN THỊ (PERMISSION & DISPLAY MANAGEMENT)
        • QUẢN LÝ NGƯỜI DÙNG (USER MANAGEMENT)
        • NGƯỜI DÙNG - QUẢN LÝ NHÓM QUYỀN (ROLE GROUP MANAGEMENT)
  1. Public API

API

API / Data tổng quan#

1. API tải danh sách dự án / domain#

Method: GET
URL: /api/domain/list
Mục đích: lấy danh sách domain / dự án để hiển thị trên màn hình Danh sách dự án
Thời điểm gọi: khi mở màn hình danh sách

Response mẫu#

{
  "status_code": 200,
  "success": true,
  "message": "success",
  "data": {
    "data": [
      {
        "id": 1,
        "name": "Bongdalu",
        "type": 1,
        "url": "https://bongdalu.us.com",
        "banner_url": "/uploads/banners/1_banner.js",
        "note": "branch: bongdalu-boz (đã đổi sang branch này từ 15:59 ngày 18/09/2025)\nbranch cũ: bongdalu-v2.0",
        "active": 1,
        "storage_url": "https://b.bongdalu.us.com/uploads",
        "is_enable_ads": 1,
        "is_enable_index": 1,
        "is_enable_tracking_banner": 0,
        "is_enable_hidden_company_link": 0,
        "is_plugin_site": 0,
        "plugin_version": null,
        "wp_version": null,
        "created_by": "Admin",
        "updated_at": "2026-03-25T08:28:14.000000Z",
        "created_at": "2024-12-30T04:55:26.000000Z",
        "ads_type": 1
      }
    ],
    "current_page": 1,
    "from": 1,
    "last_page": 2,
    "path": "http://sports-api.longtu.club/api/domain/list",
    "per_page": 20,
    "to": 20,
    "total": 21
  }
}

2. API lấy trạng thái bật/tắt quảng cáo tổng thể#

Method: GET
URL: /api/settings/ads-status
Mục đích: lấy trạng thái bật/tắt quảng cáo tổng thể để đồng bộ hiển thị tại khu vực Quản lý quảng cáo
Thời điểm gọi: khi mở màn hình danh sách dự án hoặc khi hiển thị popup thao tác quảng cáo hàng loạt

Response mẫu#

{
  "status_code": 200,
  "success": true,
  "message": "Success",
  "data": {
    "ads_enabled": true
  }
}

3. API cập nhật thông tin một dự án / domain#

Method: PUT
URL: /api/domain/update/{id}
Ví dụ: /api/domain/update/1
Mục đích: cập nhật thông tin một domain / dự án
Thời điểm gọi: khi người dùng chỉnh sửa thông tin dự án và nhấn lưu

Request body mẫu#

{
  "id": 1,
  "active": "1",
  "type": 1,
  "is_plugin_site": 0,
  "name": "Bongdalu",
  "url": "https://bongdalu.us.com",
  "banner_url": "/uploads/banners/1_banner.js",
  "note": "branch: bongdalu-boz (đã đổi sang branch này từ 15:59 ngày 18/09/2025)\nbranch cũ: bongdalu-v2.0",
  "storage_url": "https://b.bongdalu.us.com/uploads",
  "is_enable_ads": "1",
  "is_enable_index": "1"
}

4. API: tournaments#

API tournaments dùng để lấy danh sách giải đấu theo domain trong hệ thống.

Thông tin chung#

Thuộc tínhGiá trị
MethodGET
URL/api/tournaments?domain_id={domain_id}
AuthBearer Token
Mục đíchLấy danh sách giải đấu theo domain

Curl mẫu#


Param#

ParamKiểuÝ nghĩa
domain_idnumberID domain cần lấy danh sách giải

Cấu trúc response#

TrườngKiểuÝ nghĩa
status_codenumberMã trạng thái
successbooleanKết quả thành công/thất bại
messagestringThông báo
dataarrayDanh sách giải đấu

Cấu trúc data[]#

CộtÝ nghĩa
idID giải đấu
domain_idID domain
logoĐường dẫn logo
activeTrạng thái (1: active, 0: inactive)
parent_idID giải cha (nếu có)
sort_orderThứ tự hiển thị
typeLoại giải (league, subleague, cupmatch)
league_idID mapping dữ liệu gốc
translate_codeMã dịch (nếu có)
langsDanh sách tên theo ngôn ngữ
has_page_templateTrạng thái template

Cấu trúc langs[]#

CộtÝ nghĩa
idID bản ghi ngôn ngữ
tournament_idID giải đấu
nameTên giải
slugSlug URL
lang_codeMã ngôn ngữ (vn, en, th, es)

5. API: list-domain-banner#

API list-domain-banner dùng để lấy danh sách banner theo domain và loại dữ liệu cấu hình tương ứng.

Thông tin chung#

Thuộc tínhGiá trị
MethodGET
URL/api/domain-sport/list-domain-banner/{domain_id}?type={type}
AuthBearer Token
Mục đíchLấy dữ liệu banner của domain theo loại cấu hình

Curl mẫu#


Param#

ParamKiểuÝ nghĩa
domain_idnumberID domain cần lấy banner
typenumberLoại dữ liệu banner cần lấy

Cấu trúc response#

TrườngKiểuÝ nghĩa
status_codenumberMã trạng thái
successbooleanKết quả thành công/thất bại
messagestringThông báo
dataarrayDanh sách dữ liệu banner theo domain

Cấu trúc data[]#

CộtÝ nghĩa
idID nhóm dữ liệu
nameTên nhóm, ví dụ môn thể thao
activeTrạng thái hoạt động
created_atThời gian tạo
updated_atThời gian cập nhật
deleted_atThời gian xóa mềm nếu có
domain_pagesDanh sách page thuộc domain
domain_bannersDữ liệu banner của domain

Cấu trúc domain_pages[]#

CộtÝ nghĩa
idID bản ghi page của domain
domain_idID domain
page_template_idID page template
urlĐường dẫn page
nameTên page
levelCấp độ page

Cấu trúc domain_banners#

CộtÝ nghĩa
temp_pcDanh sách banner template cho desktop
temp_mbDanh sách banner template cho mobile

6. API: domain-page/list#

API domain-page/list dùng để lấy danh sách page của domain, kèm thông tin page template, banner rule và dữ liệu phân trang.

Thông tin chung#

Thuộc tínhGiá trị
MethodGET
URL/api/domain-page/list?domain_id={domain_id}
AuthBearer Token
Mục đíchLấy danh sách page theo domain

Curl mẫu#


Param#

ParamKiểuÝ nghĩa
domain_idnumberID domain cần lấy danh sách page

Cấu trúc response#

TrườngKiểuÝ nghĩa
status_codenumberMã trạng thái
successbooleanKết quả thành công/thất bại
messagestringThông báo
dataobjectKhối dữ liệu phân trang

Cấu trúc data#

CộtÝ nghĩa
dataDanh sách page của domain
current_pageTrang hiện tại
fromVị trí bắt đầu bản ghi
last_pageTrang cuối cùng
pathURL API phân trang
per_pageSố bản ghi mỗi trang
toVị trí kết thúc bản ghi
totalTổng số bản ghi

Cấu trúc data.data[]#

CộtÝ nghĩa
idID bản ghi domain page
domain_idID domain
page_template_idID page template
urlĐường dẫn page
noteGhi chú
content_titleTiêu đề nội dung
content_descriptionMô tả nội dung
activeTrạng thái hoạt động
created_byNgười tạo
updated_byNgười cập nhật
created_atThời điểm tạo
updated_atThời điểm cập nhật
page_template_nameTên page template
page_template_codeMã page template
page_template_typeLoại page template
page_template_is_bannerCờ xác định page có banner
page_template_banner_ruleRule banner desktop
page_template_banner_rule_mbRule banner mobile
page_template_noteGhi chú template
page_template_domain_sport_idID domain sport của template
page_template_levelLevel của template
domain_sport_idID môn thể thao
domain_sport_nameTên môn thể thao
domain_banner_statisticsThống kê banner nếu có

7. API: domain-banner-notification/detail#

API domain-banner-notification/detail dùng để lấy thông tin banner notification của domain.

Thông tin chung#

Thuộc tínhGiá trị
MethodGET
URL/api/domain-banner-notification/detail?domain_id={domain_id}
AuthBearer Token
Mục đíchLấy chi tiết banner notification theo domain

Curl mẫu#


Param#

ParamKiểuÝ nghĩa
domain_idnumberID domain cần lấy banner notification

Cấu trúc response#

TrườngKiểuÝ nghĩa
status_codenumberMã trạng thái
successbooleanKết quả thành công/thất bại
messagestringThông báo
dataobjectThông tin banner notification

Cấu trúc data#

CộtÝ nghĩa
idID banner notification
domain_idID domain
messageNội dung thông báo dạng HTML
activeTrạng thái hoạt động
positionVị trí hiển thị banner
created_atThời điểm tạo
updated_atThời điểm cập nhật

8. API: seo-contents/upsert#

API seo-contents/upsert dùng để tạo mới hoặc cập nhật nội dung SEO theo domain và page template.

Thông tin chung#

Thuộc tínhGiá trị
MethodPOST
URL/api/seo-contents/upsert
AuthBearer Token
Content-Typeapplication/json
Mục đíchTạo mới hoặc cập nhật nội dung SEO

Curl mẫu#


Body request#

TrườngKiểuÝ nghĩa
domain_idnumberID domain
page_template_idnumberID page template
canonical_urlstringCanonical URL chung
activenumberTrạng thái hoạt động
langsarrayDanh sách nội dung SEO theo ngôn ngữ

Cấu trúc langs[]#

TrườngKiểuÝ nghĩa
idnumberID bản ghi ngôn ngữ, dùng khi cập nhật
lang_codestringMã ngôn ngữ
titlestringSEO title
meta_descriptionstringMeta description
canonical_urlstringCanonical URL theo ngôn ngữ
h1_tagstringThẻ H1
contentstringNội dung HTML
activenumberTrạng thái hoạt động
created_atstringThời điểm tạo
updated_atstringThời điểm cập nhật
descriptionstring / nullMô tả bổ sung

Cấu trúc response#

TrườngKiểuÝ nghĩa
dataobjectDữ liệu SEO sau khi tạo/cập nhật

Cấu trúc data#

TrườngKiểuÝ nghĩa
idnumberID bản ghi SEO content
domain_idnumberID domain
page_template_idnumberID page template
canonical_urlstringCanonical URL
activenumberTrạng thái hoạt động
langsarrayDanh sách nội dung SEO theo ngôn ngữ
created_atstringThời điểm tạo
updated_atstringThời điểm cập nhật

Cấu trúc data.langs[]#

TrườngKiểuÝ nghĩa
idnumberID bản ghi ngôn ngữ
lang_codestringMã ngôn ngữ
titlestringSEO title
meta_descriptionstringMeta description
canonical_urlstringCanonical URL
h1_tagstringThẻ H1
contentstringNội dung HTML
activenumberTrạng thái hoạt động
created_atstringThời điểm tạo
updated_atstringThời điểm cập nhật
descriptionstring / nullMô tả bổ sung

9. API: company/list#

API company/list dùng để lấy danh sách company theo điều kiện lọc.

Thông tin chung#

Thuộc tínhGiá trị
MethodGET
URL/api/company/list?listAll=1&active=1
AuthBearer Token
Mục đíchLấy danh sách company

Curl mẫu#


Param#

ParamKiểuÝ nghĩa
listAllnumberCờ lấy toàn bộ dữ liệu
activenumberLọc theo trạng thái hoạt động

Cấu trúc response#

TrườngKiểuÝ nghĩa
status_codenumberMã trạng thái
successbooleanKết quả thành công/thất bại
messagestringThông báo
dataarrayDanh sách company

Cấu trúc data[]#

TrườngKiểuÝ nghĩa
idnumberID company
namestringTên company
urlstringURL company
activenumberTrạng thái hoạt động
drive_image_linkstring / nullLink hình ảnh từ drive nếu có
created_bystringNgười tạo
updated_bystringNgười cập nhật
updated_atstringThời điểm cập nhật
created_atstringThời điểm tạo

10. API: domain-banner-notification/slots#

API domain-banner-notification/slots dùng để lấy danh sách slot banner notification theo domain.

Thông tin chung#

Thuộc tínhGiá trị
MethodGET
URL/api/domain-banner-notification/slots?domain_id={domain_id}
AuthBearer Token
Mục đíchLấy danh sách slot banner notification của domain

Curl mẫu#


Param#

ParamKiểuÝ nghĩa
domain_idnumberID domain cần lấy danh sách slot

Cấu trúc response#

TrườngKiểuÝ nghĩa
status_codenumberMã trạng thái
successbooleanKết quả thành công/thất bại
messagestringThông báo
dataarrayDanh sách slot banner notification

Cấu trúc data[]#

TrườngKiểuÝ nghĩa
idnumberID bản ghi slot
domain_idnumberID domain
company_idnumberID company
company_namestringTên company
slotstringTên slot
trackingstringChuỗi tracking gắn với slot
created_atstringThời điểm tạo
updated_atstringThời điểm cập nhật

11. API: auth/refresh#

API auth/refresh dùng để làm mới access token.

Thông tin chung#

Thuộc tínhGiá trị
MethodPOST
URL/api/auth/refresh
AuthBearer Token
Content-Typeapplication/json
Mục đíchLàm mới access token

Curl mẫu#


Body request#

TrườngKiểuÝ nghĩa
bodyobjectBody rỗng {}

Cấu trúc response#

TrườngKiểuÝ nghĩa
status_codenumberMã trạng thái
successbooleanKết quả thành công/thất bại
messagestringThông báo
dataobjectThông tin token mới

Cấu trúc data#

TrườngKiểuÝ nghĩa
access_tokenstringAccess token mới
token_typestringLoại token
expires_innumberThời gian hết hạn tính bằng giây

12. API: domain-banner-notification/upsert-slot#

API domain-banner-notification/upsert-slot dùng để tạo mới hoặc cập nhật slot banner notification cho domain.

Thông tin chung#

Thuộc tínhGiá trị
MethodPOST
URL/api/domain-banner-notification/upsert-slot
AuthBearer Token
Content-Typeapplication/json
Mục đíchTạo mới hoặc cập nhật slot banner notification

Curl mẫu#


Body request#

TrườngKiểuÝ nghĩa
domain_idnumberID domain
company_idnumberID company
trackingstringChuỗi tracking của slot
slotstringTên slot cần tạo/cập nhật

Cấu trúc response#

TrườngKiểuÝ nghĩa
status_codenumberMã trạng thái
successbooleanKết quả thành công/thất bại
messagestringThông báo
dataobjectDữ liệu slot sau khi tạo/cập nhật

Cấu trúc data#

TrườngKiểuÝ nghĩa
idnumberID bản ghi slot
domain_idnumberID domain
company_idnumberID company
slotstringTên slot
trackingstringChuỗi tracking
created_atstringThời điểm tạo
updated_atstringThời điểm cập nhật

14. API: domain-banner/publish#

API domain-banner/publish dùng để xuất bản banner cho domain.

Thông tin chung#

Thuộc tínhGiá trị
MethodPOST
URL/api/domain-banner/publish
AuthBearer Token
Content-Typeapplication/json
Mục đíchXuất bản banner cho domain

Curl mẫu#


Body request#

TrườngKiểuÝ nghĩa
domain_idnumberID domain cần xuất bản banner
namestringTên đợt xuất bản hoặc ghi chú publish
typestringLoại publish

Cấu trúc response#

TrườngKiểuÝ nghĩa
status_codenumberMã trạng thái
successbooleanKết quả thành công/thất bại
messagestringThông báo
dataobjectThông tin domain sau khi publish

Cấu trúc data#

TrườngKiểuÝ nghĩa
idnumberID domain
namestringTên domain
typenumberLoại domain
urlstringURL domain
banner_urlstringURL file banner đã publish
notestring / nullGhi chú
activenumberTrạng thái hoạt động
storage_urlstring / nullURL storage
is_enable_adsnumberCờ bật quảng cáo
is_enable_indexnumberCờ bật index
is_enable_tracking_bannernumber / nullCờ tracking banner
is_enable_hidden_company_linknumber / nullCờ ẩn company link
is_plugin_sitenumberCờ site plugin
plugin_versionstring / nullPhiên bản plugin
wp_versionstring / nullPhiên bản WordPress
created_bystringNgười tạo
updated_atstringThời điểm cập nhật
created_atstringThời điểm tạo
ads_typenumberLoại quảng cáo

15. API: tournaments/left-menu/generate#

API tournaments/left-menu/generate dùng để generate và publish dữ liệu left menu của tournaments theo domain.

Thông tin chung#

Thuộc tínhGiá trị
MethodPOST
URL/api/tournaments/left-menu/generate
AuthBearer Token
Content-Typeapplication/json
Mục đíchGenerate left menu tournaments cho domain

Curl mẫu#


Body request#

TrườngKiểuÝ nghĩa
domain_idnumberID domain cần generate left menu

Cấu trúc response#

TrườngKiểuÝ nghĩa
messagestringThông báo kết quả xử lý

Response mẫu#

{
  "message": "Left menu data published successfully"
}

16. API: country/list#

API country/list dùng để lấy danh sách quốc gia/ngôn ngữ trong hệ thống.

Thông tin chung#

Thuộc tínhGiá trị
MethodGET
URL/api/country/list
AuthBearer Token
Mục đíchLấy danh sách quốc gia

Curl mẫu#


Cấu trúc response#

TrườngKiểuÝ nghĩa
status_codenumberMã trạng thái
successbooleanKết quả thành công/thất bại
messagestringThông báo
dataobjectKhối dữ liệu phân trang

Cấu trúc data#

TrườngKiểuÝ nghĩa
dataarrayDanh sách quốc gia
current_pagenumberTrang hiện tại
fromnumberVị trí bắt đầu
last_pagenumberTrang cuối
pathstringURL API phân trang
per_pagenumberSố bản ghi mỗi trang
tonumberVị trí kết thúc
totalnumberTổng số bản ghi

Cấu trúc data.data[]#

TrườngKiểuÝ nghĩa
idnumberID quốc gia
namestringTên quốc gia
codestringMã quốc gia/ngôn ngữ
url_filestring / nullFile liên quan nếu có
banner_urlstring / nullBanner của quốc gia nếu có
activenumberTrạng thái hoạt động
created_bystringNgười tạo
updated_bystringNgười cập nhật
updated_atstring / nullThời điểm cập nhật
created_atstringThời điểm tạo

17. API: country/publish-league/{id}#

API country/publish-league/{id} dùng để xuất bản dữ liệu league theo country.

Thông tin chung#

Thuộc tínhGiá trị
MethodPOST
URL/api/country/publish-league/{id}
AuthBearer Token
Mục đíchXuất bản dữ liệu league theo country

Curl mẫu#


Param#

ParamKiểuÝ nghĩa
idnumberID country cần publish league

Cấu trúc response#

TrườngKiểuÝ nghĩa
status_codenumberMã trạng thái
successbooleanKết quả thành công/thất bại
messagestringThông báo
dataobjectDữ liệu sau khi publish

Cấu trúc data#

TrườngKiểuÝ nghĩa
file_urlstringURL file JSON đã publish
dataobjectDữ liệu league theo mã country

Cấu trúc data.data#

TrườngKiểuÝ nghĩa
vnarrayDanh sách ID league của country vn

18. API: company/bulk-upsert-url#

API company/bulk-upsert-url dùng để cập nhật hàng loạt URL company theo dữ liệu input text.

Thông tin chung#

Thuộc tínhGiá trị
MethodPOST
URL/api/company/bulk-upsert-url
AuthBearer Token
Content-Typeapplication/json
Mục đíchCập nhật hàng loạt URL company

Curl mẫu#


Body request#

TrườngKiểuÝ nghĩa
textstringDữ liệu text chứa danh sách URL cần cập nhật hàng loạt
skip_if_new_existsbooleanBỏ qua nếu URL mới đã tồn tại
dry_runbooleanChạy thử, không ghi dữ liệu thật
activenumberTrạng thái active áp dụng cho dữ liệu cập nhật

Cấu trúc response lỗi#

TrườngKiểuÝ nghĩa
status_codenumberMã trạng thái
messageobjectThông tin lỗi validate

Cấu trúc message#

TrườngKiểuÝ nghĩa
messagestringThông báo lỗi chung
errorsarrayDanh sách lỗi chi tiết

Response mẫu#

{
  "status_code": 422,
  "message": {
    "message": "Input không hợp lệ",
    "errors": [
      "Old bị trùng trong input: https://789club.ci (line 5)"
    ]
  }
}

19. API: auth/login#

API auth/login dùng để đăng nhập và lấy access token.

Thông tin chung#

Thuộc tínhGiá trị
MethodPOST
URL/api/auth/login
AuthKhông bắt buộc
Content-Typeapplication/json
Mục đíchĐăng nhập hệ thống và lấy access token

Curl mẫu#


Body request#

TrườngKiểuÝ nghĩa
emailstringEmail đăng nhập
passwordstringMật khẩu đăng nhập

Cấu trúc response#

TrườngKiểuÝ nghĩa
messagestringThông báo kết quả
dataobjectThông tin token đăng nhập

Cấu trúc data#

TrườngKiểuÝ nghĩa
access_tokenstringAccess token
token_typestringLoại token
expires_innumberThời gian hết hạn tính bằng giây

20. API: auth/me#

API auth/me dùng để lấy thông tin user đang đăng nhập.

Thông tin chung#

Thuộc tínhGiá trị
MethodGET
URL/api/auth/me
AuthBearer Token
Mục đíchLấy thông tin user hiện tại

Curl mẫu#


Cấu trúc response#

TrườngKiểuÝ nghĩa
status_codenumberMã trạng thái
successbooleanKết quả thành công/thất bại
messagestringThông báo
dataobjectThông tin user hiện tại

Cấu trúc data#

TrườngKiểuÝ nghĩa
idnumberID user
namestringTên user
emailstringEmail
phonestringSố điện thoại
gendernumberGiới tính
avatarstring / nullẢnh đại diện
activenumberTrạng thái hoạt động
created_bystringNgười tạo
created_atstring / nullThời điểm tạo
role_group_idsarrayDanh sách ID nhóm quyền
role_domain_idsarrayDanh sách ID domain được phân quyền
traffic_site_idsarrayDanh sách ID traffic site được phân quyền
menusarrayDanh sách menu được phép truy cập
permissionsarrayDanh sách permission của user

Cấu trúc menus[]#

TrườngKiểuÝ nghĩa
idnumberID menu
namestringTên menu
codestringMã menu
logostring / nullIcon menu
api_urlstring / nullAPI URL liên kết
menunumberLoại menu
menu_parent_idnumberID menu cha
menu_indexnumberThứ tự hiển thị
activenumberTrạng thái hoạt động
deleted_atstring / nullThời điểm xóa
created_atstringThời điểm tạo
updated_atstringThời điểm cập nhật
created_idnumberID người tạo
updated_idnumberID người cập nhật
childrenarrayDanh sách menu con nếu có

Cấu trúc permissions[]#

TrườngKiểuÝ nghĩa
permissions[]array stringDanh sách mã quyền của user

21. API: live-sites/update-all#

API live-sites/update-all dùng để cập nhật toàn bộ dữ liệu live sites.

Thông tin chung#

Thuộc tínhGiá trị
MethodPOST
URL/ajax/live-sites/update-all
AuthKhông thấy Bearer Token trong request mẫu
Content-Typeapplication/json
Mục đíchCập nhật toàn bộ danh sách live sites

Curl mẫu#


Body request#

TrườngKiểuÝ nghĩa
dataarrayDanh sách live site cần cập nhật

Cấu trúc data[]#

TrườngKiểuÝ nghĩa
idnumberID live site
namestringTên site
domainstringDomain site
logostringLogo chính
logo2stringLogo phụ 2 nếu có
logo3stringLogo phụ 3 nếu có
logo4stringLogo phụ 4 nếu có

Cấu trúc response#

TrườngKiểuÝ nghĩa
successbooleanKết quả thành công/thất bại
messagestringThông báo kết quả

Response mẫu#

{
  "success": true,
  "message": "Cập nhật file live_sites.json thành công"
}

22. API: gf/data/live_sites.json#

API gf/data/live_sites.json dùng để lấy file dữ liệu live sites sau khi đã được cập nhật/publish.

Thông tin chung#

Thuộc tínhGiá trị
MethodGET
URL/gf/data/live_sites.json?t={timestamp}
AuthKhông thấy Bearer Token trong request mẫu
Mục đíchLấy file JSON danh sách live sites

Curl mẫu#


Param#

TrườngKiểuÝ nghĩa
tnumberTimestamp dùng để tránh cache

Cấu trúc response#

TrườngKiểuÝ nghĩa
responsearrayDanh sách live sites

Cấu trúc response[]#

TrườngKiểuÝ nghĩa
idnumberID live site
namestringTên site
domainstringDomain site
logostringLogo chính
logo2stringLogo phụ 2 nếu có
logo3stringLogo phụ 3 nếu có
logo4stringLogo phụ 4 nếu có

23. API: gf/data/supplier_text.txt#

API gf/data/supplier_text.txt dùng để lấy nội dung text/HTML supplier đã publish.

Thông tin chung#

Thuộc tínhGiá trị
MethodGET
URL/gf/data/supplier_text.txt?t={timestamp}
AuthKhông thấy Bearer Token trong request mẫu
Mục đíchLấy nội dung supplier text đã publish

Curl mẫu#


Param#

TrườngKiểuÝ nghĩa
tnumberTimestamp dùng để tránh cache

Cấu trúc response#

TrườngKiểuÝ nghĩa
responsestringNội dung text/HTML đã publish

Đặc điểm dữ liệu trả về#

TrườngKiểuÝ nghĩa
span.labelhtml tagNhãn mở đầu thông báo
a.hrefstringLink điều hướng của từng supplier/site
a.targetstringKiểu mở link, thường là _blank
a.relstringThuộc tính SEO/bảo mật của link
textstringNội dung text hiển thị

24. API: live-sites/update-all?filename=supplier_text.txt#

API live-sites/update-all với param filename=supplier_text.txt dùng để cập nhật nội dung file supplier_text.txt.

Thông tin chung#

Thuộc tínhGiá trị
MethodPOST
URL/ajax/live-sites/update-all?filename=supplier_text.txt
AuthKhông thấy Bearer Token trong request mẫu
Content-Typeapplication/json
Mục đíchCập nhật nội dung file supplier_text.txt

Curl mẫu#


Param#

TrườngKiểuÝ nghĩa
filenamestringTên file cần cập nhật

Body request#

TrườngKiểuÝ nghĩa
datastringNội dung text/HTML cần ghi vào file

Cấu trúc response#

TrườngKiểuÝ nghĩa
successbooleanKết quả thành công/thất bại
messagestringThông báo kết quả

Response mẫu#

{
  "success": true,
  "message": "Cập nhật file supplier_text.txt thành công"
}

25. API: content-creators#

API content-creators dùng để lấy danh sách content creator trong hệ thống. :contentReference[oaicite:0]{index=0}

Thông tin chung#

Thuộc tínhGiá trị
MethodGET
URL/api/content-creators
AuthBearer Token
Mục đíchLấy danh sách content creator

Curl mẫu#


Cấu trúc response#

TrườngKiểuÝ nghĩa
messagestringThông báo kết quả
dataarrayDanh sách content creator

Cấu trúc data[]#

TrườngKiểuÝ nghĩa
idnumberID content creator
typestringLoại content creator
sourcestringNguồn dữ liệu
external_idstring / nullID ngoài hệ thống nếu có
namestringTên content creator
total_tipsnumberTổng số tips
total_likesnumberTổng số lượt thích
total_followersnumberTổng số lượt theo dõi
win_rate_percentnumberTỷ lệ thắng
avatarstringẢnh đại diện
activestringTrạng thái hoạt động
created_atstringThời điểm tạo
updated_atstringThời điểm cập nhật
ranking_idnumberID ranking
ranking_namestringTên ranking

26. API: content-creators#

API content-creators dùng để lấy danh sách content creator.

Thông tin chung#

Thuộc tínhGiá trị
MethodGET
URL/api/content-creators?page={page}&per_page={per_page}
AuthBearer Token
Mục đíchLấy danh sách content creator

Curl mẫu#


Param#

TrườngKiểuÝ nghĩa
pagenumberTrang cần lấy
per_pagenumberSố bản ghi mỗi trang

Cấu trúc response#

TrườngKiểuÝ nghĩa
messagestringThông báo kết quả
dataobjectKhối dữ liệu phân trang content creator

Cấu trúc data#

TrườngKiểuÝ nghĩa
current_pagenumberTrang hiện tại
dataarrayDanh sách content creator
first_page_urlstringURL trang đầu
fromnumberVị trí bắt đầu
last_pagenumberTrang cuối
last_page_urlstringURL trang cuối
linksarrayDanh sách link phân trang
next_page_urlstring / nullURL trang tiếp theo
pathstringURL gốc phân trang
per_pagenumberSố bản ghi mỗi trang
prev_page_urlstring / nullURL trang trước
tonumberVị trí kết thúc
totalnumberTổng số bản ghi

Cấu trúc data.data[]#

TrườngKiểuÝ nghĩa
idnumberID content creator
typestringLoại content creator
sourcestringNguồn dữ liệu
external_idstring / nullID ngoài hệ thống nếu có
namestringTên content creator
total_tipsnumberTổng số tips
total_likesnumberTổng số lượt thích
total_followersnumberTổng số lượt theo dõi
win_rate_percentnumberTỷ lệ thắng
avatarstringẢnh đại diện
activestringTrạng thái hoạt động
created_atstringThời điểm tạo
updated_atstringThời điểm cập nhật
ranking_idnumberID ranking
ranking_namestringTên ranking

Cấu trúc data.links[]#

TrườngKiểuÝ nghĩa
urlstring / nullURL trang
labelstringNhãn hiển thị
activebooleanTrạng thái đang chọn

27. API: websites#

API websites dùng để lấy danh sách website và thống kê tracking. API này được gọi từ hệ thống khác.

Thông tin chung#

Thuộc tínhGiá trị
MethodGET
URL/api/v1/websites?limit={limit}&offset={offset}&sort={sort}&orderby={orderby}
Authx-api-key
Mục đíchLấy danh sách website kèm thống kê tracking

Curl mẫu#


Param#

TrườngKiểuÝ nghĩa
limitnumberSố bản ghi cần lấy
offsetnumberVị trí bắt đầu
sortstringTrường dùng để sắp xếp
orderbystringKiểu sắp xếp, ví dụ asc hoặc desc

Header request#

TrườngKiểuÝ nghĩa
x-api-keystringAPI key dùng để xác thực request

Cấu trúc response#

TrườngKiểuÝ nghĩa
dataarrayDanh sách website
pagingobjectThông tin phân trang

Cấu trúc data[]#

TrườngKiểuÝ nghĩa
idnumberID website
namestringTên website
domainstringDomain website
api_keystringAPI key của website
statisticsobjectThống kê tracking của website

Cấu trúc statistics#

TrườngKiểuÝ nghĩa
total_pathsnumberTổng số path được ghi nhận
total_clicksnumberTổng số click
total_usersnumberTổng số user
total_sessionsnumberTổng số session

Cấu trúc paging#

TrườngKiểuÝ nghĩa
totalnumberTổng số bản ghi
limitnumberGiới hạn bản ghi mỗi lần lấy
offsetnumberVị trí bắt đầu hiện tại

28. API: sites#

API sites dùng để lấy danh sách site theo phân trang, kèm thống kê tổng quan trạng thái site.

Thông tin chung#

Thuộc tínhGiá trị
MethodGET
URL/api/sites?page={page}&limit={limit}
AuthBearer Token
Mục đíchLấy danh sách site và thống kê trạng thái

Curl mẫu#


Param#

TrườngKiểuÝ nghĩa
pagenumberTrang cần lấy
limitnumberSố bản ghi mỗi trang

Cấu trúc response#

TrườngKiểuÝ nghĩa
dataarrayDanh sách site
summaryobjectThống kê tổng quan theo trạng thái
pagenumberTrang hiện tại
limitnumberSố bản ghi mỗi trang

Cấu trúc data[]#

TrườngKiểuÝ nghĩa
idstringID site
domainstringDomain của site
ipstringĐịa chỉ IP
environmentstring / nullMôi trường
first_seenstringThời điểm hệ thống ghi nhận lần đầu
last_seenstringThời điểm hệ thống ghi nhận gần nhất
statusstringTrạng thái site
componentsobject / arrayDanh sách component của site
custom_scriptstring / nullScript custom của site
inject_positionstring / nullVị trí inject script

Cấu trúc components.plugin[]#

TrườngKiểuÝ nghĩa
namestringTên plugin
versionstringPhiên bản plugin
last_updatestringThời điểm cập nhật gần nhất

Cấu trúc summary#

TrườngKiểuÝ nghĩa
totalnumberTổng số site
activenumberSố site đang active
inactivenumberSố site inactive
blockednumberSố site blocked

29. API: sites/{id}/scripts#

API sites/{id}/scripts dùng để thêm custom script cho site.

Thông tin chung#

Thuộc tínhGiá trị
MethodPOST
URL/api/sites/{id}/scripts
AuthBearer Token
Content-Typeapplication/json
Mục đíchThêm custom script cho site

Curl mẫu#


Param#

TrườngKiểuÝ nghĩa
idstringID site cần thêm script

Body request#

TrườngKiểuÝ nghĩa
custom_scriptstringNội dung script cần thêm
inject_positionstringVị trí inject script

Cấu trúc response#

TrườngKiểuÝ nghĩa
messagestringThông báo kết quả
dataobjectThông tin script vừa thêm

Cấu trúc data#

TrườngKiểuÝ nghĩa
idnumberID bản ghi script
inject_positionstringVị trí inject
scriptstringNội dung script
created_atstringThời điểm tạo

30. API: domain/list#

API domain/list dùng để lấy danh sách domain theo điều kiện lọc wp_site.

Thông tin chung#

Thuộc tínhGiá trị
MethodGET
URL/api/domain/list?wp_site={wp_site}
AuthBearer Token
Mục đíchLấy danh sách domain theo điều kiện site WordPress

Curl mẫu#


Param#

TrườngKiểuÝ nghĩa
wp_sitenumberLọc domain là site WordPress

Cấu trúc response#

TrườngKiểuÝ nghĩa
status_codenumberMã trạng thái
successbooleanKết quả thành công/thất bại
messagestringThông báo
dataobjectKhối dữ liệu phân trang domain

Cấu trúc data#

TrườngKiểuÝ nghĩa
dataarrayDanh sách domain
current_pagenumberTrang hiện tại
fromnumber / nullVị trí bắt đầu
last_pagenumberTrang cuối
pathstringURL API phân trang
per_pagenumberSố bản ghi mỗi trang
tonumber / nullVị trí kết thúc
totalnumberTổng số bản ghi

31. API: user/list#

API user/list dùng để lấy danh sách user trong hệ thống.

Thông tin chung#

Thuộc tínhGiá trị
MethodGET
URL/api/user/list
AuthBearer Token
Mục đíchLấy danh sách user

Curl mẫu#


Cấu trúc response#

TrườngKiểuÝ nghĩa
status_codenumberMã trạng thái
successbooleanKết quả thành công/thất bại
messagestringThông báo
dataobjectKhối dữ liệu phân trang user

Cấu trúc data#

TrườngKiểuÝ nghĩa
dataarrayDanh sách user
current_pagenumberTrang hiện tại
fromnumberVị trí bắt đầu
last_pagenumberTrang cuối
pathstringURL API phân trang
per_pagenumberSố bản ghi mỗi trang
tonumberVị trí kết thúc
totalnumberTổng số bản ghi

Cấu trúc data.data[]#

TrườngKiểuÝ nghĩa
idnumberID user
namestringTên user
emailstringEmail
phonestringSố điện thoại
gendernumberGiới tính
avatarstring / nullẢnh đại diện
activenumberTrạng thái hoạt động
created_bystringNgười tạo
created_atstring / nullThời điểm tạo
role_group_idsarrayDanh sách ID nhóm quyền
role_domain_idsarrayDanh sách ID domain được phân quyền
traffic_site_idsarrayDanh sách ID traffic site được phân quyền

32. API: user/update#

API user/update dùng để cập nhật thông tin user.

Thông tin chung#

Thuộc tínhGiá trị
MethodPOST
URL/api/user/update
AuthBearer Token
Content-Typeapplication/json
Mục đíchCập nhật thông tin user

Curl mẫu#


Body request#

TrườngKiểuÝ nghĩa
idnumberID user
activestring / numberTrạng thái hoạt động
gendernumberGiới tính
namestringTên user
avatarstring / nullẢnh đại diện
emailstringEmail
phonestringSố điện thoại
role_group_idsarrayDanh sách ID nhóm quyền
role_domain_idsarrayDanh sách ID domain được phân quyền
traffic_site_idsarrayDanh sách ID traffic site được phân quyền

Cấu trúc response#

TrườngKiểuÝ nghĩa
status_codenumberMã trạng thái
successbooleanKết quả thành công/thất bại
messagestringThông báo
dataobjectThông tin user sau khi cập nhật

Cấu trúc data#

TrườngKiểuÝ nghĩa
idnumberID user
namestringTên user
emailstringEmail
phonestringSố điện thoại
gendernumberGiới tính
avatarstring / nullẢnh đại diện
activenumberTrạng thái hoạt động
created_bystringNgười tạo
created_atstringThời điểm tạo
role_group_idsarrayDanh sách ID nhóm quyền
role_domain_idsarrayDanh sách ID domain được phân quyền
traffic_site_idsarrayDanh sách ID traffic site được phân quyền

33. API: role/list#

API role/list dùng để lấy danh sách menu/quyền trong hệ thống.

Thông tin chung#

Thuộc tínhGiá trị
MethodGET
URL/api/role/list
AuthBearer Token
Mục đíchLấy danh sách menu, quyền và cây phân cấp quyền

Curl mẫu#


Cấu trúc response#

TrườngKiểuÝ nghĩa
messagestringThông báo kết quả
dataarrayDanh sách menu/quyền dạng cây

Cấu trúc data[]#

TrườngKiểuÝ nghĩa
idnumberID menu/quyền
namestringTên menu/quyền
codestringMã menu/quyền
logostring / nullIcon menu
api_urlstring / nullAPI URL liên kết nếu có
activenumberTrạng thái hoạt động
checkablenumberCờ cho phép chọn phân quyền
menunumberCờ xác định có hiển thị menu
menu_parent_idnumberID menu cha
menu_indexnumberThứ tự hiển thị
created_bystringNgười tạo
updated_bystringNgười cập nhật
updated_atstringThời điểm cập nhật
created_atstringThời điểm tạo
childrenarrayDanh sách menu/quyền con

Cấu trúc children[]#

TrườngKiểuÝ nghĩa
idnumberID menu/quyền con
namestringTên menu/quyền con
codestringMã menu/quyền con
logostring / nullIcon
api_urlstring / nullAPI URL liên kết nếu có
activenumberTrạng thái hoạt động
checkablenumberCờ cho phép chọn phân quyền
menunumberCờ hiển thị menu
menu_parent_idnumberID menu cha
menu_indexnumberThứ tự hiển thị
created_bystringNgười tạo
updated_bystringNgười cập nhật
updated_atstringThời điểm cập nhật
created_atstringThời điểm tạo
childrenarrayDanh sách cấp con tiếp theo

35. API: role/create#

API role/create dùng để tạo mới menu/quyền trong hệ thống.

Thông tin chung#

Thuộc tínhGiá trị
MethodPOST
URL/api/role/create
AuthBearer Token
Content-Typeapplication/json
Mục đíchTạo mới menu/quyền

Curl mẫu#


Body request#

TrườngKiểuÝ nghĩa
idnumberID menu/quyền, tạo mới thường là 0
namestringTên menu/quyền
api_urlstringAPI URL hoặc route liên kết
page_urlstringPage URL nếu có
logostringIcon menu
codestringMã menu/quyền
activestring / numberTrạng thái hoạt động
menustring / numberCờ hiển thị menu
menu_parent_idnumberID menu cha
menu_indexnumberThứ tự hiển thị

Cấu trúc response#

TrườngKiểuÝ nghĩa
messagestringThông báo kết quả
dataobjectThông tin menu/quyền sau khi tạo

Cấu trúc data#

TrườngKiểuÝ nghĩa
idnumberID menu/quyền
namestringTên menu/quyền
codestringMã menu/quyền
logostring / nullIcon menu
api_urlstring / nullAPI URL hoặc route liên kết
activenumberTrạng thái hoạt động
checkablenumberCờ cho phép chọn phân quyền
menunumberCờ hiển thị menu
menu_parent_idnumberID menu cha
menu_indexnumberThứ tự hiển thị
created_bystringNgười tạo
updated_bystringNgười cập nhật
updated_atstringThời điểm cập nhật
created_atstringThời điểm tạo
childrenarrayDanh sách menu con

36. API: role-group/list#

API role-group/list dùng để lấy danh sách nhóm quyền trong hệ thống.

Thông tin chung#

Thuộc tínhGiá trị
MethodGET
URL/api/role-group/list
AuthBearer Token
Mục đíchLấy danh sách nhóm quyền

Curl mẫu#


Cấu trúc response#

TrườngKiểuÝ nghĩa
status_codenumberMã trạng thái
successbooleanKết quả thành công/thất bại
messagestringThông báo
dataobjectKhối dữ liệu phân trang nhóm quyền

Cấu trúc data#

TrườngKiểuÝ nghĩa
dataarrayDanh sách nhóm quyền
current_pagenumberTrang hiện tại
fromnumberVị trí bắt đầu
last_pagenumberTrang cuối
pathstringURL API phân trang
per_pagenumberSố bản ghi mỗi trang
tonumberVị trí kết thúc
totalnumberTổng số bản ghi

Cấu trúc data.data[]#

TrườngKiểuÝ nghĩa
idnumberID nhóm quyền
namestringTên nhóm quyền
codestringMã nhóm quyền
notestring / nullGhi chú
activenumberTrạng thái hoạt động
created_bystringNgười tạo
updated_bystringNgười cập nhật
updated_atstringThời điểm cập nhật
created_atstringThời điểm tạo

37. API: role-group/update#

API role-group/update dùng để cập nhật thông tin nhóm quyền.

Thông tin chung#

Thuộc tínhGiá trị
MethodPUT
URL/api/role-group/update
AuthBearer Token
Content-Typeapplication/json
Mục đíchCập nhật nhóm quyền

Curl mẫu#


Body request#

TrườngKiểuÝ nghĩa
idnumberID nhóm quyền
activestring / numberTrạng thái hoạt động
namestringTên nhóm quyền
codestringMã nhóm quyền

Cấu trúc response#

TrườngKiểuÝ nghĩa
status_codenumberMã trạng thái
successbooleanKết quả thành công/thất bại
messagestringThông báo
dataobjectThông tin nhóm quyền sau khi cập nhật

Cấu trúc data#

TrườngKiểuÝ nghĩa
idnumberID nhóm quyền
namestringTên nhóm quyền
codestringMã nhóm quyền
notestring / nullGhi chú
activenumberTrạng thái hoạt động
created_bystringNgười tạo
updated_bystringNgười cập nhật
updated_atstringThời điểm cập nhật
created_atstringThời điểm tạo
Modified at 2026-03-27 06:10:46
Previous
Production
Next
Cấu trúc Database
Built with