Nhật ký thay đổi

2026-07-21 — API công khai v1

Phát hành công khai phiên bản đầu tiên của CrawlPipe legal-vn API.

• GET /v1/legal/documents, /{id}, /{id}/effectivity, /{id}/relations — metadata văn bản có cấu trúc, cây đơn vị, và đồ thị hiệu lực.
• GET /v1/legal/search — tìm kiếm toàn văn, ngữ nghĩa và kết hợp ở cấp độ đơn vị kèm kết quả sẵn sàng trích dẫn, tối ưu cho RAG.
• GET /v1/legal/changes — luồng sự kiện thay đổi phân trang theo cursor.
• POST/GET/DELETE /v1/webhooks — thông báo đẩy khi văn bản thay đổi, được ký bằng HMAC-SHA256.
• GET /v1/usage, GET /v1/me — tự tra cứu mức sử dụng và thông tin tài khoản.
• GET /v1/meta/freshness, /v1/meta/status, /v1/meta/plans — các tín hiệu trạng thái và bảng giá công khai, không tính phí.
• @crawlpipe/mcp — mcp server stdio, tương thích 1:1 với REST API.
• Các gói Free / Builder / Pro, tính phí theo từng yêu cầu (1/2/100 đơn vị), thanh toán qua PayPal, bảo vệ phát lại idempotent trên mọi endpoint tính phí.

Định danh phiên bản đường dẫn tại /v1/. Các thay đổi bổ sung (trường mới, tham số mới) có thể phát hành mà không cần thông báo trước; các thay đổi gây breaking change sẽ luôn chuyển sang /v2/, kèm header Sunset và thời gian hỗ trợ 6 tháng cho /v1/.