API Documentation v2

Hệ thống cung cấp các REST API để tích hợp dữ liệu học tập với AI và các ứng dụng bên thứ ba.

Base URL: https://en.trucmod.fun

Tổng quan

Mọi yêu cầu API đều trả về định dạng JSON. Đối với các yêu cầu POST, hãy đảm bảo Header Content-Type: application/json.

Cấu trúc phản hồi chung (JSON):

{
  "ok": true,      // true nếu thành công, false nếu có lỗi
  "message": "...", // Thông báo (tùy chọn)
  "data": { ... }  // Dữ liệu trả về
}

POST Thêm từ vựng mới

Thêm một từ vựng mới vào kho lưu trữ. Nếu chủ đề không tồn tại, nó sẽ được tự động tạo.

/api.php

Tham số (Body)	Loại	Bắt buộc	Mô tả
`word`	string	Có	Từ tiếng Anh
`meaning`	string	Có	Nghĩa tiếng Việt
`topic`	string	Không	Tên chủ đề (Mặc định: Chung)
`example`	string	Không	Ví dụ minh họa

Success Response (200 OK):

{
  "ok": true,
  "message": "Word added successfully.",
  "data": { "id": 105, "word": "Resilient", "topic": "Personality" }
}

Error Response (409 Conflict):

{
  "ok": false,
  "error": "Word already exists in your vocabulary."
}

GET Lấy danh sách chủ đề

Trả về mảng chứa tất cả các tên chủ đề hiện có.

/api_v2.php?action=get_topics

Success Response:

{
  "ok": true,
  "data": ["Academic", "Food", "General", "Technology"]
}

POST Tạo chủ đề mới

Tạo một chủ đề học tập mới trống.

/api_v2.php?action=add_topic

Tham số (Body)	Loại	Bắt buộc	Mô tả
`topic_name`	string	Có	Tên chủ đề muốn tạo

Success Response:

{
  "ok": true,
  "message": "Topic processed"
}

GET Lấy danh sách từ vựng

Lấy toàn bộ từ vựng hoặc lọc theo chủ đề cụ thể.

/api_v2.php?action=get_words&topic={topic_name}

Tham số (Query)	Loại	Bắt buộc	Mô tả
`topic`	string	Không	Lọc theo chủ đề

Success Response:

{
  "ok": true,
  "data": [
    {
      "word": "Diligent",
      "meaning": "Siêng năng",
      "topic": "Academic",
      "proficiency": 45,
      "is_learned": 0
    }
  ]
}

💡 Tích hợp với AI (Prompt mẫu)

Hãy gửi đoạn lệnh sau cho AI của bạn (Gemini, ChatGPT) để nó tự động quản lý dữ liệu:

"Bạn là một trợ lý AI quản lý hệ thống học tiếng Anh.
- Để thêm từ mới: Gửi POST JSON tới https://en.trucmod.fun/api.php
- Để xem chủ đề: GET tới https://en.trucmod.fun/api_v2.php?action=get_topics
- Để tạo chủ đề: POST JSON topic_name tới https://en.trucmod.fun/api_v2.php?action=add_topic
Hãy ưu tiên kiểm tra chủ đề hiện có trước khi thêm từ để đảm bảo phân loại đúng."