Yinei Academy API

Tài liệu API

Các tài nguyên chính để hệ thống tự động, crawler và lập trình viên khám phá API công khai của Yinei Academy.

Điểm vào khám phá

API Catalog: /.well-known/api-catalog

Catalog trả về Linkset JSON theo RFC 9727, gồm các quan hệ service-desc, service-doc và status.

Mô tả máy đọc được

OpenAPI: /openapi.json

File OpenAPI 3.1 mô tả các nhóm API public: catalog, khóa học, tài liệu, livestream và thanh toán.

Tài liệu cho agent

Markdown: /docs/api

Bản markdown ngắn gọn để agent đọc nhanh danh sách endpoint và tài nguyên liên quan.

Trạng thái dịch vụ

Health: /api/health

Endpoint kiểm tra trạng thái API, trả về JSON khi dịch vụ backend hoạt động.

Endpoint public

  • GET /api/catalog
  • GET /api/courses/{slug}
  • GET /api/documents
  • GET /api/documents/{id}
  • GET /api/livestream/state
  • POST /api/payments/orders
  • GET /api/payments/orders/{orderId}/status
  • GET /api/x402/status
  • GET /api/x402/premium-catalog - x402 paid endpoint for agent-native HTTP payments.