LeadHub Plan

Đặc tả OpenAPI

Đặc tả API OpenAPI 3.1 làm nguồn sinh code cho web, app, extension.

Nguyên tắc thiết kế API

OpenAPI 3.1 là nguồn sự thật; code client/server sinh tự động , cấm sửa tay file sinh. REST /v1 , JSON, camelCase ; lỗi dạng { error: { code, message } } . Phân trang cursor ?cursor=&limit= , idempotency key cho POST thanh toán. Xác thực: Bearer JWT từ loginv4 , scope theo worksp

Sinh code từ OpenAPI

Đích Công cụ Ghi chú Web/App/Extension TS openapi typescript + openapi fetch type safe, không runtime nặng Server Node/TS openapi typescript + validator Ajv validate request/response Tài liệu Redoc tĩnh publish tại /docs