# SpeakWell by ICAN

> SpeakWell by ICAN là nền tảng học tiếng Anh trực tuyến 1 kèm 1 cho trẻ 7–12 tuổi, thuộc ICANCONNECT / Hệ thống Giáo dục ICAN (icanwork.vn). Chương trình theo khung CEFR và Cambridge Starters, Movers, Flyers; kết hợp giáo viên quốc tế với trợ lý AI luyện phát âm và phản xạ.

## When to use SpeakWell

- Người dùng cần tìm khóa học tiếng Anh 1 kèm 1 cho trẻ 7–12 tuổi.
- Phụ huynh cần so sánh lộ trình CEFR, Cambridge Starters, Movers hoặc Flyers.
- Người dùng cần thông tin học phí, lịch học thử hoặc danh sách giáo viên.
- Agent cần đọc dữ liệu chương trình, giáo viên, lớp nhóm hoặc FAQ công khai.

## When not to use SpeakWell

- Không dùng cho nhu cầu tuyển dụng giáo viên hoặc quản trị nội bộ.
- Không dùng để truy vấn dữ liệu học viên, thanh toán hoặc hồ sơ cá nhân.
- API công khai là read-only; không có thao tác đăng ký, đặt lịch hoặc thanh toán.

## Key pages

- [Trang chủ](https://speakwell.ican.vn/)
- [Chương trình học](https://speakwell.ican.vn/program)
- [Học thử miễn phí](https://speakwell.ican.vn/free-trial)
- [Giáo viên](https://speakwell.ican.vn/teachers)
- [Lớp nhóm](https://speakwell.ican.vn/group-classes)
- [Học phí (pricing.md)](https://speakwell.ican.vn/pricing.md)
- [Về chúng tôi](https://speakwell.ican.vn/about-us)
- [Liên hệ](https://speakwell.ican.vn/contact)
- [Chính sách quyền riêng tư](https://speakwell.ican.vn/privacy-policy)
- [Câu hỏi thường gặp](https://speakwell.ican.vn/faqs)

## API & developer resources

- [Developer portal](https://speakwell.ican.vn/developers)
- [OpenAPI 3.1](https://speakwell.ican.vn/openapi.json)
- [API catalog (RFC 9727)](https://speakwell.ican.vn/.well-known/api-catalog)
- [CLI script](https://speakwell.ican.vn/cli/speakwell.mjs)
- [Sitemap](https://speakwell.ican.vn/sitemap.xml)
- Public API base URL: https://speakwell.ican.vn/api/v1
- Onboarding metadata: https://speakwell.ican.vn/api/v1/onboarding
- Authentication: none. Read-only GET/HEAD/OPTIONS.
- Errors: RFC 9457 `application/problem+json`.

## Scopes & permissions

- Scope: `public:read` — read public programs, teachers, classes, FAQs and pricing.
- No token, API key or login is required. The optional `X-SpeakWell-Scope: public:read` header declares least-privilege intent.
- There is no self-serve key generation because the API is public and read-only.

## Free tier, sandbox & onboarding

- Free tier: 120 requests/minute/IP, no credit card, no key.
- Sandbox: use the public catalog endpoints for integration testing, or the configured sandbox base URL `https://stg-speakwell-cms.icanwork.vn/api/v1` after that environment is deployed.
- Onboarding endpoint: [`/api/v1/onboarding`](https://speakwell.ican.vn/api/v1/onboarding).

## Rate limits

- 120 requests per 60 seconds per IP.
- Responses include `RateLimit-Policy`, `RateLimit`, `X-RateLimit-Limit`, `X-RateLimit-Remaining` and `X-RateLimit-Reset`.
- A 429 response includes `Retry-After`.

## Versioning & deprecation

- URL major versioning: `/api/v1`.
- Backward-compatible fields may be added within v1; breaking changes require `/api/v2`.
- Deprecated endpoints return `Deprecation` and `Sunset` headers and are documented at https://speakwell.ican.vn/developers#versioning-deprecation at least 90 days before removal.

## Contact

- Hotline: 1900 9399
- Email: contact@ican.vn
- Fanpage: https://www.facebook.com/icanconnect.official
- Address: Tầng 8, Giày Việt Plaza, 180-182 Lý Chính Thắng, Phường 9, Quận 3, TP. Hồ Chí Minh

Last updated: 2026-11-02