TÀI LIỆU · API & DỮ LIỆU CÔNG KHAI

Hiểu WordPounce, từ người đến máy.

Một nơi để tìm thông tin sản phẩm, cấu trúc kho từ và các định dạng đọc bằng máy. Nội dung công khai dùng chung nguồn với website và game.

Vào vườn từ →

Hai API chỉ đọc đang có

Các endpoint dưới đây không cần đăng nhập, không tạo phiên chơi và không truy cập hồ sơ. Chúng trả snapshot được tạo khi triển khai, không phải dữ liệu realtime của một trận.

Thông tin sản phẩm

GET /api/v1/product

Tên sản phẩm, chức năng hiện có, trạng thái tích hợp AI và các đường dẫn chính thức.

Xem JSON →

Kho từ tiếng Anh

GET /api/v1/catalog

Toàn bộ mục từ công khai với ID, nghĩa, IPA, chủ đề, cấp độ tối thiểu và URL audio. Cấp độ cao hơn bao gồm các từ của cấp thấp hơn.

Xem JSON →

Hợp đồng API

Base URL: https://wordpounce.online. Phiên bản hiện tại: v1. Hỗ trợ GET, HEAD và OPTIONS. Không có bộ lọc, phân trang hay endpoint ghi dữ liệu trong API công khai này; có thể lọc snapshot phía client.

curl https://wordpounce.online/api/v1/product
curl https://wordpounce.online/api/v1/catalog

Tải đặc tả OpenAPI JSON →

Phản hồi JSON có cache 5 phút; ứng dụng nên giữ lại snapshot và dùng ETag để kiểm tra cập nhật. Không có SLA hoặc API key cho API dữ liệu này. Gọi endpoint không cần thiết theo từng lượt game sẽ không làm dữ liệu mới hơn.

Dữ liệu nào không nằm trong API công khai?

Không trả token, mã khôi phục, lịch sử cá nhân, danh sách phiên hoặc state phòng. API gameplay và WebSocket của ứng dụng là giao thức nội bộ, chưa phải nền tảng tích hợp cho bên thứ ba. Điểm và thưởng do máy chủ xử lý; các endpoint đọc dữ liệu không thể cộng điểm hay tham gia trận.

Công cụ tìm kiếm và AI có thể đọc gì?

sitemap.xml: URL HTML canonical; bài blog có ngày cập nhật nội dung.
robots.txt: hướng dẫn thu thập và vị trí sitemap.
llms.txt: chỉ mục ngắn với liên kết nội dung.
llms-full.txt: nội dung công khai đầy đủ trong một file.
Markdown của trang này: các trang nội dung có bản index.md tương ứng, được liên kết trong HTML và HTTP Link.
RSS Blog: theo dõi bài viết mới bằng trình đọc feed.

Các định dạng này giúp truy cập thông tin thuận tiện; không bảo đảm được lập chỉ mục, xếp hạng hay được một AI trích dẫn. llms.txt là một đề xuất cộng đồng. Google không yêu cầu một file AI đặc biệt để xuất hiện trong AI Overviews hoặc AI Mode.

AI trong sản phẩm: tình trạng hiện tại

WordPounce chưa tích hợp Claude API vào game. Audio từ vựng là bản ghi có sẵn, không được tạo bằng Claude khi chơi. Các endpoint trên cung cấp dữ liệu sản phẩm, không cung cấp dịch vụ AI hay chatbot. Tiếng Trung và tiếng Nhật cũng chưa có trong phiên bản đang chạy.

Giữ thông tin nhất quán khi mở rộng

Kho từ, HTML học theo chủ đề và JSON được sinh từ cùng danh mục. Bài blog có tác giả thương hiệu và ngày biên soạn; chỉ đổi ngày cập nhật khi thay nội dung. Mỗi lần phát hành kiểm tra đường dẫn, metadata, sitemap, Markdown và hợp đồng dữ liệu để tránh công bố một chức năng chưa có.

Tham khảo: OpenAPI 3.1.2, đề xuất llms.txt, Google Search: AI features and your website.