Swagger nằm ở đâu?
Đặc tảopenapi.json nằm trong repository docs và dùng để hiển thị các trang API. Đây là tài liệu bổ sung từ source hiện tại. Swagger UI hoặc endpoint phục vụ OpenAPI trong application: Not Found. Not confirmed by current source code.
Mở file openapi.json ở thư mục gốc repository docs bằng công cụ hỗ trợ OpenAPI. Các trang endpoint sử dụng cơ chế OpenAPI của Mintlify.
Không giả định application có /swagger, /api-docs hoặc /openapi.json. Danh sách đầy đủ route và method nằm tại Danh mục route.
Đặc tả chưa đặt servers vì docs không có URL gốc application được xác nhận dùng chung cho mọi môi trường. Các trang dùng chế độ đọc hợp đồng, không có nút gửi request. Nếu mẫu cURL hiện https://api.example.com, đó là URL minh họa của trình hiển thị; thay bằng URL backend của môi trường kiểm thử trước khi chạy.
Chọn nhóm API
Hai loại phiên khác nhau
accessToken gửi tới endpoint xác minh Zalo khác với token phiên Taho trả về. Token cư dân không thay thế phiên admin. Header preview chỉ dành cho nhánh ngoài production được mô tả tại Chạy Mini App local.
Mutation quản trị còn kiểm tra nguồn request, quyền route/action và dữ liệu đầu vào. Chỉ có token chưa bảo đảm yêu cầu được chấp nhận.
Đọc response
Các endpoint trong đặc tả dùng một trong hai cấu trúc sau:data phụ thuộc endpoint; error.details chỉ xuất hiện khi handler cung cấp. Workflow admin có thể trả redirectTo trong JSON, còn file export/attachment và MCP có hợp đồng riêng. Không áp dụng mẫu JSON này cho mọi route.
Đọc Cấu hình môi trường và Chỉ mục testcase để nối cấu hình, request và mục tiêu nghiệp vụ.