OpenAPI Spec - Vero OMS Docs

Dùng các file OpenAPI khi generate client, validate payload hoặc đưa context API cho AI tools.

Specification files

File	Mục đích
`/openapi.oms.en.json`	REST API reference tiếng Anh dùng cho English docs
`/openapi.oms.vi.json`	REST API reference tiếng Việt dùng cho Vietnamese docs

Tài liệu REST API hiện có 51 thao tác HTTP, bao gồm đăng nhập bằng mật khẩu, xác minh hai lớp và tiếp tục phiên.

Dùng với AI tools

Đưa OpenAPI file cho model kèm instruction này:

Build against the Vero OMS OpenAPI spec.
Use the operation's method and path exactly.
Use Bearer authentication for protected endpoints.
Inspect the login response status before reading jwt.
For mfa_required, preserve the response cookie and complete two-factor verification.
Validate all path, query, and body fields against the schema.
Treat response schemas as authoritative for payload shape and field meanings.
Handle documented error responses.

Checklist cho client

Tìm operation theo method hoặc path.
Đọc toàn bộ path, query, header và body parameters.
Build request từ typed fields; tránh tự nối string nếu có structured client.
Parse success response theo schema đã document.
Parse error response defensive vì error payload có thể khác nhau theo điểm fail.